# context7 probes, 2026-09-18T06:16Z, from a cloud container (one IP), no credentials, no payment
# Responses are cut at 6000 bytes (initialize), 20000 (tools/list), 2500 (protected resource), 9000 (authorization server), 4000 (REST). Nothing here was sent with a credential.

## 1. MCP initialize, POST https://mcp.context7.com/mcp
$ curl -sS -i -m 25 -X POST https://mcp.context7.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '<initialize>'
HTTP/1.1 200 Connection Established

HTTP/1.1 200 OK
X-Powered-By: Express
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET,POST,OPTIONS,DELETE
Access-Control-Allow-Headers: Content-Type, MCP-Session-Id, MCP-Protocol-Version, Mcp-Method, Mcp-Name, X-Context7-API-Key, Context7-API-Key, X-API-Key, Authorization
WWW-Authenticate: Bearer resource_metadata="https://mcp.context7.com/.well-known/oauth-protected-resource"
cache-control: no-cache, no-transform
content-type: text/event-stream
x-accel-buffering: no
Date: Fri, 18 Sep 2026 06:16:37 GMT
strict-transport-security: max-age=63072000; includeSubDomains
Transfer-Encoding: chunked

event: message
data: {"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":false},"prompts":{"listChanged":false},"resources":{"listChanged":false,"subscribe":false}},"serverInfo":{"name":"Context7","version":"4.1.1","websiteUrl":"https://context7.com","description":"Context7 provides up-to-date documentation and code examples for libraries and frameworks.","icons":[{"src":"https://context7.com/context7-icon-green.png","mimeType":"image/png"}]},"instructions":"Use this server to fetch current documentation whenever the user asks about a library, framework, SDK, API, CLI tool, or cloud service — even well-known ones like React, Next.js, Prisma, Express, Tailwind, Django, or Spring Boot. This includes API syntax, configuration, version migration, library-specific debugging, setup instructions, and CLI tool usage. Use even when you think you know the answer — your training data may not reflect recent changes. Prefer this over web search for library docs.\n\nDo not use for: refactoring, writing scripts from scratch, debugging business logic, code review, or general programming concepts."},"jsonrpc":"2.0","id":1}



## 1b. MCP tools/list, POST https://mcp.context7.com/mcp (initialize answered 200; the session id from step 1 is sent back when the server issued one)
$ curl -sS -i -m 25 -X POST https://mcp.context7.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -H 'MCP-Protocol-Version: 2025-06-18' [-H 'Mcp-Session-Id: <from step 1>'] -d '<tools/list>'
# tools counted over the whole response before the cut, by occurrences of "inputSchema": 2 (0 means no list came back)
HTTP/1.1 200 Connection Established

HTTP/1.1 200 OK
X-Powered-By: Express
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET,POST,OPTIONS,DELETE
Access-Control-Allow-Headers: Content-Type, MCP-Session-Id, MCP-Protocol-Version, Mcp-Method, Mcp-Name, X-Context7-API-Key, Context7-API-Key, X-API-Key, Authorization
WWW-Authenticate: Bearer resource_metadata="https://mcp.context7.com/.well-known/oauth-protected-resource"
cache-control: no-cache, no-transform
content-type: text/event-stream
x-accel-buffering: no
Date: Fri, 18 Sep 2026 06:16:38 GMT
strict-transport-security: max-age=63072000; includeSubDomains
Transfer-Encoding: chunked

event: message
data: {"result":{"tools":[{"name":"resolve-library-id","title":"Resolve Context7 Library ID","description":"Resolves a package/product name to a Context7-compatible library ID and returns matching libraries.\n\nYou MUST call this function before 'Query Documentation' tool to obtain a valid Context7-compatible library ID UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query.\n\nEach result includes:\n- Library ID: Context7-compatible identifier (format: /org/project)\n- Name: Library or package name\n- Description: Short summary\n- Code Snippets: Number of available code examples\n- Source Reputation: Authority indicator (High, Medium, Low, or Unknown)\n- Benchmark Score: Quality indicator (100 is the highest score)\n- Versions: List of versions if available. Use one of those versions if the user provides a version in their query. The format of the version is /org/project/version.\n\nFor best results, select libraries based on name match, source reputation, snippet coverage, benchmark score, and relevance to your use case.\n\nSelection Process:\n1. Analyze the query to understand what library/package the user is looking for\n2. Return the most relevant match based on:\n- Name similarity to the query (exact matches prioritized)\n- Description relevance to the query's intent\n- Documentation coverage (prioritize libraries with higher Code Snippet counts)\n- Source reputation (consider libraries with High or Medium reputation more authoritative)\n- Benchmark Score: Quality indicator (100 is the highest score)\n\nResponse Format:\n- Return the selected library ID in a clearly marked section\n- Provide a brief explanation for why this library was chosen\n- If multiple good matches exist, acknowledge this but proceed with the most relevant one\n- If no good matches exist, clearly state this and suggest query refinements\n\nFor ambiguous queries, request clarification before proceeding with a best-guess match.\n\nIMPORTANT: Do not call this tool more than 3 times per question. If you cannot find what you need after 3 calls, use the best result you have.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"query":{"type":"string","description":"What to look up in the library's documentation. This is used to rank library results by relevance to what the user is trying to accomplish. The query is sent to the Context7 API for processing. Do not include any sensitive or confidential information such as API keys, passwords, credentials, personal data, or proprietary code in your query."},"libraryName":{"type":"string","description":"Library name to search for and retrieve a Context7-compatible library ID. Use the official library name with proper punctuation — e.g., 'Next.js' instead of 'nextjs', 'Customer.io' instead of 'customerio', 'Three.js' instead of 'threejs'."}},"required":["query","libraryName"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":true,"idempotentHint":true}},{"name":"query-docs","title":"Query Documentation","description":"Retrieves and queries up-to-date documentation and code examples from Context7 for any programming library or framework.\n\nYou must call 'Resolve Context7 Library ID' tool first to obtain the exact Context7-compatible library ID required to use this tool, UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query.\n\nDo not call this tool more than 3 times per question.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"libraryId":{"type":"string","description":"Exact Context7-compatible library ID (e.g., '/mongodb/docs', '/vercel/next.js', '/supabase/supabase', '/vercel/next.js/v14.3.0-canary.87') retrieved from 'resolve-library-id' or directly from user query in the format '/org/project' or '/org/project/version'."},"query":{"type":"string","description":"What to look up in the library's documentation, scoped to a single concept. Be specific and include relevant details, but keep each query to one topic — if the user's question spans multiple distinct concepts, make a separate call per concept instead of combining them, unless the question is about how the concepts interact. Good: 'How to set up authentication with JWT in Express.js' or 'React useEffect cleanup function examples'. Bad (too vague): 'auth' or 'hooks'. Bad (too broad): 'routing and auth and caching in Next.js'. The query is sent to the Context7 API for processing. Do not include any sensitive or confidential information such as API keys, passwords, credentials, personal data, or proprietary code in your query."}},"required":["libraryId","query"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":true,"idempotentHint":true}}]},"jsonrpc":"2.0","id":2}



## 2. Protected-resource metadata, GET https://mcp.context7.com/.well-known/oauth-protected-resource
HTTP/1.1 200 Connection Established

HTTP/1.1 200 OK
X-Powered-By: Express
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET,POST,OPTIONS,DELETE
Access-Control-Allow-Headers: Content-Type, MCP-Session-Id, MCP-Protocol-Version, Mcp-Method, Mcp-Name, X-Context7-API-Key, Context7-API-Key, X-API-Key, Authorization
Content-Type: application/json; charset=utf-8
Content-Length: 194
ETag: W/"c2-77ZteB/FgLZ0Mqn6hPZZKCj+sVY"
Date: Fri, 18 Sep 2026 06:16:38 GMT
strict-transport-security: max-age=63072000; includeSubDomains

{"resource":"https://mcp.context7.com","authorization_servers":["https://clerk.context7.com","https://context7.com"],"scopes_supported":["profile","email"],"bearer_methods_supported":["header"]}

## 3. Authorization-server metadata, GET https://clerk.context7.com/.well-known/oauth-authorization-server
HTTP/1.1 200 Connection Established

HTTP/2 200 
date: Fri, 18 Sep 2026 06:16:39 GMT
content-type: application/json
content-length: 1199
set-cookie: __cf_bm=[redacted by the prober: a session cookie, never published]
set-cookie: _cfuvid=[redacted by the prober: a session cookie, never published]
cf-ray: a3ce391eca7c9005-BOS
cf-cache-status: HIT
accept-ranges: bytes
access-control-allow-origin: *
age: 2701
cache-control: public, max-age=14400
expires: Fri, 18 Sep 2026 10:16:39 GMT
last-modified: Fri, 18 Sep 2026 05:31:39 GMT
server: cloudflare
x-robots-tag: noindex, nofollow
strict-transport-security: max-age=63072000;
vary: Origin
via: 1.1 google
clerk-api-version: 2025-04-10
content-security-policy: default-src 'none'; frame-ancestors 'none'
x-cfworker: 1
x-clerk-instance-id: ins_30gaCqqKNQXbl8FhNX7C8xuDxgO
x-clerk-trace-id: 827a66542c3d2c4854a65f51d233d195
x-cloud-trace-context: 9966c5c455c5966a234730cb0f227792
x-country: US
report-to: {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=LA61WevpzeMEjVzBbDJDm3Aml9hzpGoSNosl1IWUVzPLw1%2BkzZcCrJbGzbbTn77gkzmM4xcScpYSLocwOuZCaP2J%2FgKINckriwxQyngXLL3Aw2AjAwqIic7sAjLb9jznWQ6VOA%3D%3D"}]}
nel: {"report_to":"cf-nel","success_fraction":0.01,"max_age":604800}

{"issuer":"https://clerk.context7.com","authorization_endpoint":"https://clerk.context7.com/oauth/authorize","token_endpoint":"https://clerk.context7.com/oauth/token","revocation_endpoint":"https://clerk.context7.com/oauth/token/revoke","device_authorization_endpoint":"https://clerk.context7.com/oauth/device_authorization","jwks_uri":"https://clerk.context7.com/.well-known/jwks.json","registration_endpoint":"https://clerk.context7.com/oauth/register","response_types_supported":["code"],"grant_types_supported":["authorization_code","refresh_token","urn:ietf:params:oauth:grant-type:device_code"],"token_endpoint_auth_methods_supported":["client_secret_basic","none","client_secret_post"],"scopes_supported":["openid","profile","email","public_metadata","private_metadata","offline_access"],"subject_types_supported":["public"],"id_token_signing_alg_values_supported":["RS256"],"claims_supported":["sub","iss","aud","exp","iat","email","name"],"service_documentation":"https://clerk.com/docs/oauth/scoped-access","ui_locales_supported":["en"],"op_tos_uri":"https://clerk.com/legal/standard-terms","code_challenge_methods_supported":["S256"],"authorization_response_iss_parameter_supported":true}

## 4. REST, GET https://context7.com/api/v2/libs/search?query=astro, no Authorization header
HTTP/1.1 200 Connection Established

HTTP/2 200 
age: 0
cache-control: public, max-age=0, must-revalidate
content-type: application/json
context7-quota-tier: anonymous
date: Fri, 18 Sep 2026 06:16:41 GMT
ratelimit-limit: 200
ratelimit-remaining: 181
ratelimit-reset: 1790812800
server: Vercel
strict-transport-security: max-age=63072000
vary: rsc, next-router-state-tree, next-router-prefetch, next-router-segment-prefetch
x-clerk-auth-reason: session-token-and-uat-missing
x-clerk-auth-status: signed-out
x-matched-path: /api/v2/libs/search
x-vercel-cache: MISS
x-vercel-id: iad1::sfo1::ks9lw-1789712200200-03e97c902e43

{"results":[{"id":"/withastro/docs","title":"Astro","description":"Astro is an all-in-one web framework for building fast, content-focused websites, designed to help everyone succeed in building sites.","branch":"main","lastUpdateDate":"2026-09-14T03:16:07.801Z","state":"finalized","totalTokens":641898,"totalSnippets":5999,"stars":1457,"trustScore":8.5,"benchmarkScore":85.89,"versions":[]},{"id":"/websites/astro_build_en","title":"Astro","description":"Astro is a modern web framework for building fast, content-focused websites with islands architecture, supporting multiple UI frameworks and server rendering.","branch":"main","lastUpdateDate":"2026-07-19T03:19:01.516Z","state":"finalized","totalTokens":431216,"totalSnippets":5584,"stars":-1,"trustScore":10,"benchmarkScore":78.66,"versions":[]},{"id":"/websites/deepwiki_withastro_astro","title":"Astro (Deepwiki)","description":"Astro is a web framework and site builder designed for content-focused websites, featuring server-side rendering, partial hydration with Astro Islands, and support for multiple UI frameworks.","branch":"main","lastUpdateDate":"2026-09-04T21:57:12.322Z","state":"finalized","totalTokens":49714,"totalSnippets":544,"stars":-1,"trustScore":8.4,"benchmarkScore":0,"versions":[]},{"id":"/llmstxt/astro_build_llms-full_txt","title":"Astro","description":"Astro is a web framework for building fast, content-driven websites with a server-first architecture, offering UI-agnostic support and zero JavaScript by default.","branch":"_llmstxt_","lastUpdateDate":"2026-03-25T21:41:08.924Z","state":"finalized","totalTokens":750828,"totalSnippets":3140,"stars":-1,"trustScore":10,"benchmarkScore":83,"versions":[]},{"id":"/llmstxt/astro_build_llms_txt","title":"Astro","description":"Astro is an all-in-one web framework for building high-performance, content-focused websites with an island architecture and server-first design.","branch":"_llmstxt_","lastUpdateDate":"2026-03-13T06:49:19.258Z","state":"finalized","totalTokens":150350,"totalSnippets":1361,"stars":-1,"trustScore":10,"benchmarkScore":83.12,"versions":[]}],"searchFilterApplied":false}