{"schema_version":"2026-05-28","name":"The Fly MCP","publisher":"The Fly","description":"The Fly MCP exposes The Fly market intelligence plus OAuth-scoped account tools through its full MCP service. A separate compact, read-only ChatGPT profile is available for the OpenAI app.","homepage_url":"https://mcp.thefly.com","server_url":"https://mcp.thefly.com/mcp","agent_setup":{"format":"thefly-mcp-agent-setup","schema_version":1,"name":"The Fly MCP","transport":"streamable-http","documentation":{"human":"https://mcp.thefly.com/","markdown":"https://mcp.thefly.com/setup.md","agent_index":"https://mcp.thefly.com/llms.txt","manifest":"https://mcp.thefly.com/MANIFEST.json"},"endpoints":{"full":"https://mcp.thefly.com/mcp","chatgpt":"https://mcp.thefly.com/chatgpt/mcp"},"authentication":{"api_key":{"endpoint":"https://mcp.thefly.com/mcp","preferred_header":"X-API-Key","environment_variable":"THEFLY_MCP_API_KEY","compatibility_header":"Authorization: Bearer <MCP API key>","send_one_credential_header_only":true,"credentials_in_url_allowed":false,"sign_in_url":"https://mcp.thefly.com/dev/login","manage_keys_url":"https://mcp.thefly.com/dev/keys","existing_keys_remain_valid":true},"oauth":{"configuration_present":true,"readiness_url":"https://mcp.thefly.com/readyz","authorization_server_metadata":"https://mcp.thefly.com/.well-known/oauth-authorization-server","full_resource_metadata":"https://mcp.thefly.com/.well-known/oauth-protected-resource","chatgpt_resource_metadata":"https://mcp.thefly.com/.well-known/oauth-protected-resource/chatgpt/mcp","flow":"authorization_code","pkce":"S256","dynamic_client_registration":true,"manually_supplied_client_id":"leave blank for native Claude connector","manually_supplied_client_secret":"leave blank for native Claude connector","raw_auth0_tokens_accepted_as_mcp_bearer":false,"human_sign_in_and_consent_required":true}},"clients":{"claude_code":{"config_file":".mcp.json","environment_expansion":"Claude Code expands this variable from the local environment; never substitute it in a shared file.","config":{"mcpServers":{"thefly":{"type":"http","url":"https://mcp.thefly.com/mcp","headers":{"X-API-Key":"${THEFLY_MCP_API_KEY}"}}}}},"claude_native_connector":{"endpoint":"https://mcp.thefly.com/mcp","authentication":"oauth2","api_key_required":false,"advanced_oauth_fields":"leave blank","surfaces":["Claude web","Claude Desktop"]},"chatgpt_app":{"endpoint":"https://mcp.thefly.com/chatgpt/mcp","authentication":"oauth2","api_key_supported":false,"read_only":true},"other_header_capable_clients":{"endpoint":"https://mcp.thefly.com/mcp","header":"X-API-Key","note":"Use the client-specific secret store and configuration syntax; environment substitution is not universal."}},"account_choice":{"human_account":"For an existing The Fly user, sign in and use the developer keys page. An agent-created account does not inherit that user’s subscriptions or personal data.","agent_account":{"explicit_user_approval_required":true,"method":"POST","url":"https://mcp.thefly.com/dev/api/signup","body_template":{"email":"<user-approved contact email>","password":"<locally generated password of at least 10 characters>","label":"coding-agent","agent":true},"response_fields":["email","portal_credential","mcp_url","keys"],"note":"New accounts have no API keys. Retain the generated agent email and portal credential separately from the human account; the portal credential manages this account but cannot authenticate to MCP. Never ask for a password or key in chat.","explicit_key_creation":{"explicit_user_approval_required":true,"method":"POST","url":"https://mcp.thefly.com/dev/api/keys/create","body_template":{"api_key":"<returned portal_credential>","label":"coding-agent"},"response_fields":["api_key","one_time_secret","mcp_url","auth_header"],"note":"This separate explicit action creates the MCP key. Store the new one-time secret directly in an approved local secret store; do not log or echo it."}}},"safety":["Ask before creating an account, writing client configuration, replacing a key, buying a plan, or changing personal data.","Never put keys, passwords, tokens or cookies in chat, model context, URLs, source control or logs.","Never pass an MCP API key as an OAuth Client ID or Client Secret. Never reuse an upstream Auth0 token as an MCP credential.","The full endpoint includes OAuth-scoped personal mutations; do not execute those during setup verification."],"verification":["Use the client SDK to initialize and complete the MCP handshake, then tools/list.","With user approval, run one harmless read-only tool, such as search_symbols for AAPL.","Report the endpoint, authentication type, non-secret config location and test outcome; never report a credential value."],"feedback":{"tool":"submit_feedback","when":"After finishing your task, report once per distinct problem: a tool error, wrong, stale or empty data, a missing tool or parameter, or a confusing description. Improvement ideas are welcome.","fields":"kind (bug, tool_gap, data_quality, docs, suggestion, other), summary (10-200 characters), optional details, tool_name, severity (low, medium, high) and client.","limits":"Works with an API key or OAuth. Up to 20 reports per account per UTC day. It does not use normal tool quota. Reports are kept for 180 days.","safety":"Never include API keys, tokens, passwords or personal data. Obvious secrets and email addresses are redacted, but do not rely on that."},"troubleshooting":{"consent_csrf":"Consent session or CSRF validation failed: start one fresh authorization from the client in the same browser. Close stale consent tabs; do not refresh or resubmit the failed page. Leave native Claude advanced OAuth fields blank. Do not bypass CSRF or disable browser security.","repeated_consent_failure":"Collect client surface/version, browser, exact time/time zone and error-only screenshot. Do not send authorization URLs, cookies, headers, form bodies or HAR exports.","unauthorized":"HTTP 401: verify endpoint and credential type. Missing or rejected credentials are not a reason to rotate a working key automatically.","quota":"HTTP 429: respect Retry-After and account quotas; reconnecting or replacing keys is not a quota workaround."}},"chatgpt_server_url":"https://mcp.thefly.com/chatgpt/mcp","logo_url":"https://mcp.thefly.com/assets/thefly-logo.svg","support_email":"support@thefly.com","tool_groups":["investor-workflows","news","kpis","transcripts","financials","calendars","symbols"],"tool_profile":"full","routes":{"full":{"server_url":"https://mcp.thefly.com/mcp","tool_profile":"full","read_only":false,"authentication":["api_key","oauth2"]},"chatgpt":{"name":"The Fly Market Intelligence","description":"Research companies, earnings, catalysts, market news, and stock screens through a compact read-only MCP toolset.","server_url":"https://mcp.thefly.com/chatgpt/mcp","tool_profile":"chatgpt","read_only":true,"tools":["research_company","analyze_earnings","get_company_catalysts","build_market_brief","search_symbols","search_news_articles","get_news_story","screen_stocks"],"authentication":["oauth2"],"oauth_resource":"https://mcp.thefly.com/chatgpt/mcp","protected_resource_metadata":"https://mcp.thefly.com/.well-known/oauth-protected-resource/chatgpt/mcp"}},"auth":{"api_key_url":"https://mcp.thefly.com/dev/signup","oauth_issuer":"https://mcp.thefly.com","oauth_authorize_url":"https://mcp.thefly.com/oauth/authorize","oauth_token_url":"https://mcp.thefly.com/oauth/token","oauth_revocation_url":"https://mcp.thefly.com/oauth/revoke","status":"account-sign-in-enabled; The Fly sign-in can authorize personal watchlist and portfolio tools"}}