bots.st/api-evangelist

api-evangelist

API governance and documentation analysis

1899 ms

answered our call 8 Nov, 02:32 UTC

State: Answered
Protocol: MCP 2025-06-18
Tools listed: 83
Answered: 3 of the last 3 calls

How to reach it

MCP, HTTPhttps://mcp.apievangelist.com/mcp

What it can do

Tool	What it says it 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.
`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.
`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.
`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`.
`baseline_violations`	PRO — Adopt a ruleset on a legacy API without a wall of red: snapshot today's violations as a baseline, then pass that baseline back to fail only on NEW violations (with fixed counts, a warning budget and burndown).
`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.
`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.
`code_snippets`	Generate runnable curl, JavaScript, and Python samples for every operation, with path params filled in and a realistic body.
`company_dimensions`	PRO — a company's investment dimensions, each read AGAINST the measured cohort: the cohort median, mean and max, this company's rank and percentile, and an index where 1.0 is exactly typical. A raw dimension score is unreadable on its own; these are the columns that make it mean something.
`company_gaps`	A company's weakest investment dimensions — where it is thin. Pro.
`company_peers`	PRO — the companies most comparable to this one (same sub-sector where the data supports it, same industry otherwise), each with signal totals and top dimensions. The response says which basis it used.
`company_signals`	PRO — the company's adopted stack entity by entity (services, tools, standards), each with how many companies across the cohort carry it and its radar ring.
`company_whitespace`	PRO — what this company's peers run that it does not, ranked by how many peers carry it. The opening list for a vendor selling into the account.
`deprecation_posture`	Report every deprecated operation and whether it actually announces a sunset. The ones that go quiet are the ones that break consumers.
`describe_rule`	Look up one rule by id — description, severity, given/then, reference — and its remediation prompt: what to change when it fires. Suggests close matches for an unknown id.
`detect_format`	Identify a document: OpenAPI (Swagger 2.0 vs 3.x), AsyncAPI, Arazzo, JSON Schema, APIs.json, MCP, an agent SKILL.md, an Overlay or a ruleset — and how many catalog rules and which named profiles apply.
`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.
`document_ruleset`	Generate human-readable Markdown documentation for a ruleset — each rule's severity, what it checks, its message and how to fix it. Pass `ruleset`, or `profile` for a curated one (owasp, problem-details, fhir, api-authorization).
`entity_demand`	PRO — THE INVERSION. Every other insights tool runs company -> stack; this one runs stack -> companies: which companies show demand for a given service, tool or standard, broken down by industry. This is the prospecting query — "who should I be selling this to" — and it exists in no report, bundle…
`explain_rule_result`	Explain why a rule did or did not fire on a document: whether its formats matched, what its `given` matched, what `then` checked, and the verdict. Works for your own rules, the catalog, and the built-ins.
`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.
`federate_rulesets`	PRO — Model a central baseline ruleset and the domains that adopt it (inherit / override / waive / defer / local rules) and compute divergence per rule, drift per domain, and local rules worth promoting.
`find_areas`	The 77 focused topic areas of the network (agents, gateways, security, …), each a subsite with its own catalog.
`find_building_blocks`	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).
`find_company_insights`	Browse profiled companies (Fortune 1000 + API providers) by name; ranked by technology-readiness signal. Free.
`find_conversations`	API Evangelist Conversations — recorded discussions with API practitioners (guest, company, YouTube/SoundCloud links).
`find_entities`	Browse the demand-side entity catalog — every service, tool and standard companies are measured against, ranked by how many carry it. Free. This is the left-hand side of the inversion: pick an entity here, then call entity_demand to see WHO.
`find_measured_standards`	The standards bodies API Evangelist has actually MEASURED — repositories, maturity, governance, coalition. Distinct from find_standards, which searches 613 catalog entries describing what a standard IS. Free.
`find_papers`	API Evangelist papers — single-PDF deep dives on one practice or topic, with outlines.
`find_posts`	Search or browse 5,100+ API Evangelist stories (2010–present); filter by year or tags.
`find_related`	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.
`find_services`	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`	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`	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`	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`	The API Evangelist video library — interviews and discussions from across the API space, searchable by transcript.
`find_vocabulary`	The API vocabulary — thousands of resources, actions, personas, domains, schemas, and tags extracted from the API landscape. Filter by category.
`fingerprint_generator`	PRO — For a code-first API: identify which OpenAPI generator produced the spec, and split findings into those to fix with code annotations vs. spec authoring, with per-generator remediation.
`fix_diagnostics`	PRO — Propose an OpenAPI Overlay that fixes the lint errors (or the `rules` you name), apply it, re-lint, and report what was resolved, what newly fires, and any breaking change. Review the overlay before applying it.
`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.
`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`	One topic area with its related-area graph resolved — walk the network from here.
`get_building_block`	One building block by type + slug; include=["content"] returns the full body.
`get_company_insight`	Full demand-side profile for one company: 40-dimension readiness, adopted stack, per-quarter history. Pro.
`get_contact`	Every way to reach API Evangelist — email, contact form, newsletter, GitHub, social channels, and postal mail.
`get_conversation`	One conversation with guest detail and media links; include=["content"] returns the writeup.
`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`	One editorial guidance section as a list: history, technology, business, politics, governance, or evangelism — the six lenses API Evangelist organizes guidance through.
`get_org_ruleset`	PRO — Read your org default ruleset: the one every governance call without its own `ruleset` runs against.
`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…
`get_paper`	One paper with its full outline and purchase/landing URL.
`get_post`	One story by slug (YYYY-MM-DD-slug); include=["content"] returns the full markdown body.
`get_service`	Full detail for one service offering by slug; include=["content"] inlines the full pitch.
`get_solution`	One solution from the vendor registry by slug, with its website and adoption count.
`get_stats`	PRO — catalog intelligence: per-type counts, stories-per-year, and the top tags by reach across the network.
`get_tag`	One tag with its per-type counts and everything it labels across the whole network (stories, areas, guidance, papers, …). Filter with types.
`get_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).
`get_tool`	One tool from the tooling registry by slug, with its website, adoption count, and radar ring.
`get_video`	One video by slug with its YouTube id; include=["content"] returns the full transcript.

And 23 more tools.

In its maker's words

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

Website: developer.apievangelist.com
Source: github.com/api-evangelist/apievangelist-aws
Publisher: apievangelist.com
Listed from: the official MCP Registry as com.apievangelist/api-evangelist
Version: 1.0.0, updated 2 Jul 2026
Kinds of work: AI models and agent tools, Search and research, Documents and files

The domain it lives on

apievangelist.com: registered 3 Aug 2010 (16 years ago), at Cloudflare, Inc., its home page is a working site

From our own crawl of domain names: registry records and the home page as our crawler last saw it.

Every call we made

When	What happened	Time
8 Nov, 02:32 UTC	Answered	1899 ms
7 Nov, 23:10 UTC	Answered	3243 ms
7 Nov, 21:28 UTC	Answered	1085 ms

Next door

Is this your bot? Claim its address to add a verified badge and keep the listing current.