mcp server

api-evangelist

Sixteen years of API research as MCP tools — stories, areas, governance blocks & services

Description as published by the maintainer. Source

• version 1.0.0
• archived
• retrieval

archived — The linked repository returns 404. It was deleted, renamed or made private. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.

What this server can do

57 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

api_coverage

Measure how much of an API description your governance actually inspects — coverage by section, each rule's reach, and the rules that match nothing. Like test coverage, one altitude up. Required: document.

api_scorecard

Score an API's maturity 0-100 with a letter grade across design, governance coverage, documentation, and (from an apis.json) discoverability, agent-readiness, and operations. Pass your own `ruleset` — a score against rules you never adopted means little. Required: document.

apply_overlay

Apply an OpenAPI Overlay to a document and report what each action matched. Use it for deprecation and migration choreography without forking the contract. Required: document, overlay.

audit_pipeline

Score a repository's Spectral CI setup against an 8-point maturity rubric and return a prioritized punch-list. Pass a public `repo` ("owner/name") or `files`.

certify_api

Issue a tamper-evident governance certificate attesting an API passed a named ruleset at a profile threshold. A SHA-256 fingerprint lets anyone re-verify it. Required: api.

classify_api_fields

Inventory the PII, secret, and sensitive fields an OpenAPI exposes, across parameters and request/response schemas. Run this before exposing an API to agents. Required: document.

code_snippets

Generate runnable curl, JavaScript, and Python samples for every operation, with path params filled in and a realistic body. Required: document.

company_gaps(slug)

A company's weakest investment dimensions — where it is thin. Pro. Required: slug.

deprecation_posture

Report every deprecated operation and whether it actually announces a sunset. The ones that go quiet are the ones that break consumers. Required: document.

diff_api_versions

Compare two OpenAPI versions and classify every change as breaking, non-breaking, or an addition — at path, operation, parameter, request-body, and response granularity. Required: old, new.

export_agent_rules

Turn a governance ruleset into agent-native guidance — an AGENTS.md block, a system-prompt set, a per-rule remediation pack, and a digest — so agents follow the rules while authoring, not after linting. Required: ruleset.

find_areas(q, page, sort, tags, limit, match, fields)

The 77 focused topic areas of the network (agents, gateways, security, …), each a subsite with its own catalog.

find_building_blocks(q, page, sort, tags, type, limit, match, fields)

Search the governance building blocks by type: guidance (177), rules (617), policies (283), standards (432), strategies (75), schema (11), properties (790), experiences (46), lifecycle (29). Required: type.

find_company_insights(q, page, limit)

Browse profiled companies (Fortune 1000 + API providers) by name; ranked by technology-readiness signal. Free.

find_conversations(q, page, sort, tags, limit, match, fields)

API Evangelist Conversations — recorded discussions with API practitioners (guest, company, YouTube/SoundCloud links).

find_papers(q, page, sort, tags, limit, match, fields)

API Evangelist white papers — deep dives distilled from sixteen years of research, with outlines.

find_posts(q, page, sort, tags, year, limit, match, fields)

Search or browse 5,100+ API Evangelist stories (2010–present); filter by year or tags.

find_related(slug, type, limit, types)

Given any doc (type + slug), the most related content across the whole network, ranked by shared-tag relevance (rare, specific tags weigh most). "More like this," across stories, areas, guidance, papers, conversations, and more. Required: type, slug.

find_services(q, page, sort, tags, limit, match, fields)

The services API Evangelist offers teams and customers — API strategy, governance, discovery, and evangelism engagements by Kin Lane. The front door to working with API Evangelist. (For the third-party vendor registry, use find_solutions.)

find_solutions(q, page, sort, tags, limit, match, fields)

The solutions registry — 740+ third-party API services and tools (gateways, portals, testing, monitoring, …) ranked by adoption across the companies API Evangelist tracks.

find_tags(q, page, sort, limit)

Browse and rank the network tag taxonomy — every subject tag across 16k+ docs, by frequency or breadth (how many content types use it). Search with q. The map of what API Evangelist covers.

find_tools(q, page, sort, tags, limit, match, fields)

The open-source tooling registry — 400+ tools in use across the companies API Evangelist tracks, each with adoption counts and technology-radar placement.

find_videos(q, page, sort, tags, limit, match, fields)

The API Evangelist video library — interviews and discussions from across the API space, searchable by transcript.

find_vocabulary(q, page, sort, tags, limit, match, fields, category)

The API vocabulary — thousands of resources, actions, personas, domains, schemas, and tags extracted from the API landscape. Filter by category.

forge_mcp_tools

From an OpenAPI, forge an MCP server design, per-operation tools, Agent Skills, an enriched OpenAPI, a server.json, and apis.json properties. Required: document.

gate_agent_context

Choose which operations and fields an API exposes to agents and emit a governed Tyk OpenAPI, an MCP tool manifest, and a Spectral ruleset with PII and secret checks.

generate_agent_descriptor

Generate an API's llms.txt and an AGENTS.md consumption contract — base URL, auth, the operation table, deprecated operations to avoid, and usage rules.

get_area(slug)

One topic area with its related-area graph resolved — walk the network from here. Required: slug.

get_building_block(slug, type, include)

One building block by type + slug; include=["content"] returns the full body. Required: type, slug.

get_company_insight(slug)

Full demand-side profile for one company: 40-dimension readiness, adopted stack, per-quarter history. Pro. Required: slug.

get_contact

Every way to reach API Evangelist — email, contact form, newsletter, GitHub, social channels, and postal mail.

get_conversation(slug, include)

One conversation with guest detail and media links; include=["content"] returns the writeup. Required: slug.

get_feeds

The static machine-readable feeds every network site publishes (JSON, APIs.json, zero-auth) — the no-key alternative to this API.

get_guidance_section(page, limit, section)

One editorial guidance section as a list: history, technology, business, politics, governance, or evangelism — the six lenses API Evangelist organizes guidance through. Required: section.

get_overview

START HERE. What the API Evangelist network offers: sixteen years of API research as searchable stories, 77 topic areas, governance building blocks (guidance, rules, policies, standards, strategies), papers, conversations, and the consulting services Kin Lane offers teams. Returns counts, entry points, and how to engage.

get_paper(slug)

One paper with its full outline and purchase/landing URL. Required: slug.

get_post(slug, include)

One story by slug (YYYY-MM-DD-slug); include=["content"] returns the full markdown body. Required: slug.

get_service(slug, include)

Full detail for one service offering by slug; include=["content"] inlines the full pitch. Required: slug.

get_solution(slug)

One solution from the vendor registry by slug, with its website and adoption count. Required: slug.

get_stats

PRO — catalog intelligence: per-type counts, stories-per-year, and the top tags by reach across the network.

get_tag(page, slug, limit, types)

One tag with its per-type counts and everything it labels across the whole network (stories, areas, guidance, papers, …). Filter with types. Required: slug.

get_timeline(page, limit, timeline)

One of the four research timelines in chronological order: api (the moments that shaped web APIs), resources (which digital resources became APIs and when), industries (the industrial history framing API infrastructure), people (the people who made compute and APIs possible). Required: timeline.

get_tool(slug)

One tool from the tooling registry by slug, with its website, adoption count, and radar ring. Required: slug.

get_video(slug, include)

One video by slug with its YouTube id; include=["content"] returns the full transcript. Required: slug.

govern_estate

PRO — Run the core governance checks across a WHOLE SET of internal APIs and roll them up: per-API score/grade/errors/PII, plus estate aggregates (avg score, grade distribution, APIs with PII/secrets) and a worst-first punch-list of what to fix. Pass `apis` ([{id, document}]) and your own `ruleset`. detail:true adds per-API dimensions. Required: apis.

governance_report

Turn Spectral findings into a self-contained HTML governance report — severity summary, grouped by rule, framed toward progress. Required: results.

guide_topic(topic)

PRO — Curated guide to one API topic (e.g. "gateways", "api governance", "discovery", "agents"). Bundles the matching topic area (with related areas), top guidance, rules, policies, and standards, relevant papers and recent stories, plus the API Evangelist services that can help a team with this topic. Required: topic.

insights_adoption(page, type, limit)

Services, tools, or standards ranked by how many companies adopt them. Free.

insights_dimensions(page, limit)

Cross-section ranking of the 40 tracked investment dimensions (AI, cloud, governance, …) by company signal. Free.

map_api_experience

Map each REST operation to its MCP tool and Agent Skill — the API -> MCP -> Agent-Skill chain — from an APIs.json, with a free/paid coverage scorecard and a flow map.

mock_payloads

Generate an example request and success-response payload for every operation from its schema. Required: document.

reconcile_waivers

Reconcile a waivers file against lint output: suppress sanctioned violations and surface the expired, stale, and expiring ones. Returns the effective failing set a build should gate on. Required: waivers, violations.

score_reusability

Score how reusable a set of APIs is and detect duplication across them — the anti-sprawl view of an estate.

search_api_evangelist(q, page, sort, tags, limit, match, types, fields)

Unified search across the whole network: 5k+ stories, 77 topic areas, 2.5k governance building blocks, papers, conversations, videos, tools, timelines, services, and vocabulary. Filter with types (posts, areas, guidance, rules, policies, standards, strategies, schema, properties, experiences, lifecycle, conversations, videos, papers, services, solutions, tools, timelines, vocabulary).

validate_api

Lint an OpenAPI, AsyncAPI, Arazzo, or JSON Schema document against the curated best-of-breed ruleset (Spectral) and return the findings. Pass your own `ruleset` to run rules you own instead of the catalog — which is what you should do before gating on anything. Required: document.

validate_onboarding

Validate an API Onboarding Descriptor (AID) against the api-commons schema and report which optional sections it fills in. Required: descriptor.

verify_certificate

Re-verify a governance certificate against the API it attests to. If the API drifted or the certificate was forged, verification fails. Required: certificate, api.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.apievangelist.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.apievangelist.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/api-evangelist/apievangelist-aws
• Website — https://developer.apievangelist.com
• Remote endpoint (streamable-http) — https://mcp.apievangelist.com/mcp