Add the LangChain page, document the stdio MCP server, stop a false claim - #16
Conversation
Three fixes, each verified against the live gateway or the published package. `getanyapi.com/docs/langchain` 404s, so our open PR against LangChain's own integrations tables (langchain-ai/docs#5886) had to point `docs_url` at a GitHub README instead of at us. `langchain.mdx` serves that exact URL. Every tool name, argument and default on it came from installing `langchain-anyapi` 0.1.0 from PyPI and printing each tool's `.name` and `.args_schema.model_json_schema()`, not from the README. The MCP page described only the hosted endpoint. `getanyapi-com/mcp` now publishes a local stdio server that forwards to it, for clients that cannot speak remote Streamable HTTP. The npx, Claude Code and Docker recipes are the ones the MCP Registry entry `io.github.getanyapi-com/anyapi` declares at 0.1.2. The page also told customers that `list_apis`, `search_apis` and `get_api` work "without a key". They do not, and have not. Measured against production: an anonymous `initialize` and `tools/list` both return 200, and `tools/call` on each of those three returns HTTP 401 `unauthorized`. What is keyless is the handshake and the tool listing. The note now says that, and points at `GET /catalog` and `GET /catalog/search`, which really are keyless (both 200 with no credential). This documents current behavior and asks for no change to it. Quickstart now says `q` is optional on `/catalog/search`. Measured today: `?platform=reddit` and `?category=social` each return 200, and a bare `/catalog/search` returns 400 `"name q, category, or platform"`. The generated API reference already had this right. Gate: check-docs-nav.sh, check-agent-contract.sh, mint validate, and mint broken-links all pass. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Review note: things I found and deliberately did not fixEach of these is outside the contract of this PR. Recording them rather than widening the change. 1. This page documents 8 tools. The server publishes 10. 2. Every tool requires a A customer building a call from the tables on this page is missing a required field. I left all of this alone because bringing the section up to date is a real piece of work with product judgment in it: whether 3. The same false "without a key" claim is published in two more places, both outside this repo. The MCP Registry entry 4. A stale MCP Registry record is still served as 5. 6. Disclosure. While checking the URLs in the |
Three fixes to customer docs, each verified against the live gateway or the published package rather than described from memory.
1.
getanyapi.com/docs/langchainwas a 404, and it cost us a listingOur open PR against LangChain's own integrations tables (langchain-ai/docs#5886) had to point
docs_urlat a GitHub README, because their rule prefers a partner documentation URL and ours 404ed.New page
langchain.mdxserves exactlyhttps://getanyapi.com/docs/langchainonce this merges.Every claim on it was verified by installing
langchain-anyapi0.1.0 from PyPI and printing each tool's.nameand.args_schema.model_json_schema():Return shapes, the
ANYAPI_API_KEY/api_key=/base_url/timeout/max_retriesoptions, the real async path, and the error payload were read from the package source, whichdiff -rproves is byte-identical to the published wheel. No billed call was made.One correction the page makes to the package README: the README's
create_agentexample needslangchaininstalled alongsidelangchain-anyapi, which only depends onlangchain-core. The install line here sayspip install langchain langchain-anyapi.2. The local stdio MCP server was undocumented
mcp-server.mdxdescribed only the hosted endpoint. New section Run it locally over stdio coversgetanyapi-com/mcp, which forwards to it for clients that cannot speak remote Streamable HTTP.The npx, Claude Code and Docker recipes are the ones the MCP Registry entry
io.github.getanyapi-com/anyapideclares at 0.1.2 (npmanyapi-mcp@0.1.2,runtimeHint: npx, stdio, envANYAPI_API_KEY; ocighcr.io/getanyapi-com/mcp:0.1.2,runtimeHint: docker). Theclaude mcp addform matches the CLI's own--help. Node>=20and bin nameanyapi-mcpare from the npm registry document.The page notes the image is
linux/amd64only, so it runs under emulation on Apple Silicon and prints a platform warning on startup.3. One published sentence was false
The note said discovery (
list_apis,search_apis,get_api) works without a key. It does not, and has not.Measured against production, anonymous:
initializetools/listtools/callsearch_apisunauthorizedtools/calllist_apisunauthorizedtools/callget_apiunauthorizedWhat is keyless is the handshake and the tool listing, not the discovery tools. The note now says that, and points at the endpoints that really are keyless:
GET /catalogandGET /catalog/searchboth return 200 with no credential, whileGET /v1/apisandGET /v1/apis/{sku}return 401.This documents current behavior and proposes no change to it. Whether to allow keyless
tools/callfor a discovery allow-list is a product decision, and it is not made here.Also:
qis optional on catalog searchMeasured today:
?platform=reddit→ 200,?category=social→ 200, bare/catalog/search→ 400"name q, category, or platform". Quickstart now says so and shows a scoped example. The generated API reference and thesearch_apisaccordion already had this right, so neither changed.Gate
Not done here, on purpose
langchain-ai/docs#5886is untouched. Itsdocs_urlcan only point at the new page once the page is live, which is after this merges.mcp-server.mdxis out of date beyond the one sentence fixed here, and I did not widen the change to cover it. See the review note below.🤖 Generated with Claude Code