twitterapi-io-mcp

# Recipe: Fetch `/documentation/authentication` (snapshot-first) Goal: access the TwitterAPI.io docs page at `/documentation/authentication` using `get_twitterapi_url`, with a safe fallback strategy. ## JSON tool calls Snapshot lookup (fast, offline): ```json { "tool": "get_twitterapi_url", "arguments": { "url": "/documentation/authentication" } } ``` If it’s missing from the snapshot, retry with live fetch: ```json { "tool": "get_twitterapi_url", "arguments": { "url": "/documentation/authentication", "fetch_live": true } } ``` Alternative (same content by page key): ```json { "tool": "get_twitterapi_guide", "arguments": { "guide_name": "authentication" } } ``` ## JavaScript (robust) ```js async function tool(name, args) { const res = await callTool(name, args); if (res?.isError) throw new Error(res?.content?.[0]?.text ?? `Tool failed: ${name}`); return res?.structuredContent ?? {}; } let page; try { page = await tool("get_twitterapi_url", { url: "/documentation/authentication" }); } catch { // If not in the snapshot, fetch live (allowed hosts only). page = await tool("get_twitterapi_url", { url: "/documentation/authentication", fetch_live: true }); } // If you specifically want the snapshot guide by key: const guide = await tool("get_twitterapi_guide", { guide_name: "authentication" }); ```