{ "markdown": "

\n \"Social\n

\n\n

Social Fetch MCP

\n\n

\n Let your coding agent fetch real social media and web data while it builds.\n

\n\n

\n Documentation\n |\n API reference\n |\n Credits & billing\n

\n\n

\n Server URL: https://api.socialfetch.dev/mcp\n

\n\n## What Is This?\n\nSocial Fetch MCP connects Cursor, VS Code, Claude, Windsurf, and other MCP clients to the Social Fetch API. Once installed, your agent can look up creators, fetch posts, search platforms, read web pages, check your balance, and read the Social Fetch docs from inside your editor.\n\nUse it when you want your agent to answer questions like:\n\n- \"Find this TikTok creator and add their latest videos to my app.\"\n- \"Pull the transcript for this YouTube video and summarize the sponsorships.\"\n- \"Fetch this Instagram post, inspect the response shape, and wire it into my backend.\"\n- \"Read the Social Fetch docs and choose the right endpoint for Reddit search.\"\n\nThe MCP server itself is hosted by Social Fetch:\n\n```text\nhttps://api.socialfetch.dev/mcp\n```\n\nThere is no local server to clone, build, or run from this repository. Clients connect to the hosted Streamable HTTP endpoint and authenticate with OAuth in the browser.\n\n## Why Use It?\n\nAgents are better when they can work with the same API your app uses. This gives them a direct, authenticated route to Social Fetch instead of making you bounce between docs, dashboards, scripts, and pasted JSON.\n\n- **Less setup:** call Social Fetch tools directly from your agent.\n- **Better answers:** the agent can search and read the live docs before choosing an endpoint.\n- **Real data in the loop:** test with TikTok, Instagram, YouTube, X/Twitter, Reddit, Spotify, web, and more from inside your editor.\n- **No API keys in editor config:** sign in once with OAuth.\n- **Same API everywhere:** MCP tools map to the public REST API, SDK, and docs.\n\n## What You Can Fetch\n\nSocial Fetch MCP exposes endpoint tools for:\n\n- TikTok, Instagram, YouTube, X/Twitter, Telegram, Facebook, Threads, LinkedIn, Reddit, and Spotify data.\n- Profiles, posts, videos, comments, transcripts, search results, and platform-specific metadata.\n- Web markdown generation and AI-assisted web page questions.\n- Account identity and credit balance.\n- Social Fetch docs through `docs_search` and `docs_read`.\n\nEndpoint tools are metered like the REST API. Docs tools, `auth_whoami`, and `billing_balance_get` do not consume lookup credits.\n\n## Requirements\n\n- A [Social Fetch](https://www.socialfetch.dev) account.\n- Credits for metered API routes.\n- An MCP client with remote Streamable HTTP support and OAuth, such as Cursor, VS Code, Claude Code, Claude Desktop, or MCP Inspector.\n\n## One-Click Install\n\n- \"\" Install in Cursor\n- \"\" Install in VS Code\n- \"\" Install in Windsurf\n- [Open the hosted install page](https://www.socialfetch.dev/docs/integrations/mcp)\n\nComplete the **OAuth** browser flow after installing. If a one-click link does nothing - your editor is not installed, blocks custom URL schemes, or has no handler - use the manual setup below.\n\n## Manual Setup\n\n### Cursor\n\nAdd this to `~/.cursor/mcp.json` or a project `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"socialfetch\": {\n \"url\": \"https://api.socialfetch.dev/mcp\"\n }\n }\n}\n```\n\nRestart Cursor, open MCP settings, and complete the OAuth browser flow when prompted.\n\n### VS Code\n\nAdd this to `settings.json`:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"socialfetch\": {\n \"url\": \"https://api.socialfetch.dev/mcp\"\n }\n }\n }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http socialfetch https://api.socialfetch.dev/mcp\n```\n\nThen run `/mcp` and authenticate Social Fetch to finish the OAuth flow.\n\n### Claude Desktop\n\nAdd a custom remote MCP connector with this URL:\n\n```text\nhttps://api.socialfetch.dev/mcp\n```\n\nAuthorize Social Fetch when Claude prompts you.\n\n### stdio-only Clients\n\nIf your client only supports stdio MCP servers, bridge to the hosted server with `mcp-remote`:\n\n```bash\nnpx mcp-remote https://api.socialfetch.dev/mcp\n```\n\nPoint your client at the stdio process that command starts.\n\n## Authentication\n\nSocial Fetch MCP uses OAuth 2.1. Your MCP client handles the flow:\n\n1. The client opens Social Fetch sign-in in your browser.\n2. You sign in or create an account and approve access.\n3. The client receives an access token and sends it with each MCP request.\n\nDo not paste a Social Fetch API key into MCP config. Credits are charged to the signed-in account, just like REST API requests.\n\n## Tools\n\n`tools/list` exposes endpoint tools plus docs tools.\n\nEndpoint tool names match API operation IDs with dots replaced by underscores:\n\n| Tool name | API operation |\n| --- | --- |\n| `tiktok_profile_get` | `tiktok.profile.get` |\n| `instagram_post_get` | `instagram.post.get` |\n| `web_markdown_generate` | `web.markdown.generate` |\n| `auth_whoami` | `auth.whoami` |\n| `billing_balance_get` | `billing.balance.get` |\n\nEach endpoint tool's arguments mirror the matching API route parameters. See the [API reference](https://www.socialfetch.dev/docs/api) for the full endpoint catalog, argument schemas, response shapes, and pricing.\n\nTwo docs tools are also available:\n\n| Tool name | Purpose |\n| --- | --- |\n| `docs_search` | Search Social Fetch docs across API, SDK, auth, errors, credits, and integrations. |\n| `docs_read` | Read a full docs page as markdown by pathname, such as `/docs/sdk`. |\n\nRecommended agent prompt:\n\n> Use the Social Fetch MCP docs to add TikTok profile lookup to this app with the TypeScript SDK.\n\n## Example: TikTok Profile\n\nIn Cursor, MCP Inspector, or another MCP client, call `tiktok_profile_get` with:\n\n```json\n{ \"handle\": \"nike\" }\n```\n\nThe result contains the same `data` and `meta` envelope returned by the REST API. Check `meta.creditsCharged` and `meta.requestId` after metered calls.\n\n## Troubleshooting\n\n| Symptom | What to check |\n| --- | --- |\n| `401` on every call | Reconnect the server and complete OAuth again. Your token may be missing or expired. |\n| OAuth redirect loop | Finish signing in at Social Fetch, then approve access to return to your client. |\n| `402` responses | Your account is out of credits for the metered route. Top up in [Credits & billing](https://www.socialfetch.dev/docs/credits). |\n| No tools listed | Reconnect the server. If it persists, restart your MCP client. |\n| Client only supports stdio | Use `npx mcp-remote https://api.socialfetch.dev/mcp`. |\n\n## Repository Contents\n\n- `server.json` - MCP Registry metadata for the hosted remote server.\n- `examples/` - Copy-paste MCP client configuration snippets.\n- `assets/socialfetch-mark.svg` - Local copy of the Social Fetch mark (also served at `https://api.socialfetch.dev/mcp/icon.svg`).\n\nThe implementation lives in Social Fetch's private API service, not in this public listing repository.\n\n## Related\n\n- [Social Fetch MCP docs](https://www.socialfetch.dev/docs/integrations/mcp)\n- [Social Fetch API reference](https://www.socialfetch.dev/docs/api)\n- [TypeScript SDK](https://github.com/social-freak-ltd/socialfetch-sdk)\n- [n8n community node](https://github.com/social-freak-ltd/n8n-nodes-socialfetch)\n\n## License\n\nMIT (c) Social Freak Ltd\n", "bytes": 8409, "sha": "c12ce4b095477b6482ec31bb448f4aea9e185d63bbdbd568f2ab95cf67a18a74", "repo_slug": "social-freak-ltd/socialfetch-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_social_freak_ltd_socialfetch_17340288/readme" }