{"openapi":"3.1.0","info":{"title":"Social Graph API","version":"0.1.0","description":"Cross-platform social graph primitives for AI agents. 9 tools across Instagram, TikTok, YouTube, Facebook, and Reddit. Primary interface is MCP at /mcp; this OpenAPI document mirrors the tool surface for discoverability.","contact":{"url":"https://github.com/SwiftAdviser/social-mcp"},"license":{"name":"MIT"}},"servers":[{"url":"https://social-mcp.thespawn.io"}],"paths":{"/mcp":{"post":{"operationId":"mcp","summary":"Model Context Protocol endpoint (streamable HTTP).","description":"JSON-RPC 2.0 over HTTP. Use 'initialize', 'tools/list', 'tools/call'. See https://modelcontextprotocol.io for protocol spec.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"JSON-RPC response or SSE stream"}}}},"/.well-known/agent-metadata.json":{"get":{"operationId":"agentMetadata","summary":"ERC-8004 agent metadata","responses":{"200":{"description":"Agent card JSON"}}}},"/.well-known/agent-card.json":{"get":{"operationId":"a2aCard","summary":"A2A Protocol agent card v0.3.0","responses":{"200":{"description":"A2A agent card"}}}}},"components":{"schemas":{"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"type":"string","examples":["initialize","tools/list","tools/call"]},"params":{"type":"object"}}}}},"x-mcp-tools":[{"name":"profile_lookup","upstream":"social.profile.lookup","price_credits":60,"description":"Fetch one profile by handle or platform-native id."},{"name":"profile_search","upstream":"social.profile.search","price_credits":60,"description":"Search profiles, pages, groups, or users by keyword."},{"name":"content_search","upstream":"social.content.search","price_credits":60,"description":"Search public posts by keyword, hashtag, tag, or music."},{"name":"content_list","upstream":"social.content.list","price_credits":60,"description":"List recent content for a known profile or community."},{"name":"content_get","upstream":"social.content.get","price_credits":60,"description":"Fetch one known post or comment by id."},{"name":"comments_list","upstream":"social.comments.list","price_credits":60,"description":"List comments on a known post."},{"name":"comments_replies","upstream":"social.comments.replies","price_credits":60,"description":"List replies to a known comment."},{"name":"network_connections","upstream":"social.network.connections","price_credits":60,"description":"List followers or following for a profile."},{"name":"ephemeral_list","upstream":"social.ephemeral.list","price_credits":60,"description":"List stories or highlights for a profile."}],"x-platforms":["instagram","tiktok","youtube","facebook","reddit"]}