{"id":26648594,"url":"https://github.com/OctagonAI/octagon-mcp-server","last_synced_at":"2025-03-25T00:02:16.214Z","repository":{"id":282128597,"uuid":"947569884","full_name":"OctagonAI/octagon-mcp-server","owner":"OctagonAI","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-13T00:24:23.000Z","size":30,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T00:25:18.919Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OctagonAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-12T22:40:51.000Z","updated_at":"2025-03-13T00:24:27.000Z","dependencies_parsed_at":"2025-03-13T00:35:38.006Z","dependency_job_id":null,"html_url":"https://github.com/OctagonAI/octagon-mcp-server","commit_stats":null,"previous_names":["octagonai/octagon-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctagonAI%2Foctagon-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctagonAI%2Foctagon-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctagonAI%2Foctagon-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctagonAI%2Foctagon-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OctagonAI","download_url":"https://codeload.github.com/OctagonAI/octagon-mcp-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245372380,"owners_count":20604491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-25T00:02:09.028Z","updated_at":"2025-03-25T00:02:16.187Z","avatar_url":"https://github.com/OctagonAI.png","language":"JavaScript","funding_links":[],"categories":["Finance","Business \u0026 Commerce MCP Servers","Production-Ready Servers","پیاده‌سازی‌های سرور","Research \u0026 Data","官方 MCP 服务器列表","💹 \u003ca name=\"finance\"\u003e\u003c/a\u003eFinance","Official Servers","APIs and HTTP Requests","📦 Other","Finance \u0026 Fintech","Table of Contents","📚 Projects (2474 total)","🗂️ Extensions by Category","Other"],"sub_categories":["Stock Data \u0026 Analytics","💰 \u003ca name=\"finance--fintech\"\u003e\u003c/a\u003eمالی و فین‌تک","Finance","MCP Servers","📊 Analytics"],"readme":"# Octagon MCP Server\n\nA Model Context Protocol (MCP) server implementation that integrates with Octagon API for investment research capabilities.\n\n## Features\n\n- Specialized AI agents for investment research of public and private markets\n- SEC filings analysis and data extraction\n- Earnings call transcript analysis\n- Financial metrics and ratios analysis\n- Stock market data access\n- Private company research\n- Web scraping capabilities\n- Comprehensive research tools\n- Funding rounds and venture capital research\n- M\u0026A and IPO transaction research\n- Streaming support for real-time responses\n- Simple interface with a single \"prompt\" parameter for all tools\n\n## Documentation\n\nFor comprehensive documentation on using Octagon agents, please visit our official documentation at:\n[https://docs.octagonagents.com](https://docs.octagonagents.com)\n\nThe documentation includes:\n- Detailed API references\n- Agent-specific query guidelines\n- Examples and use cases\n- Best practices for investment research\n\n## Installation\n\n### Running with npx\n\n```bash\nenv OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp\n```\n\n### Manual Installation\n\n```bash\nnpm install -g octagon-mcp\n```\n\n### Running on Cursor\n\nConfiguring Cursor 🖥️\nNote: Requires Cursor version 0.45.6+\n\nTo configure Octagon MCP in Cursor:\n\n1. Open Cursor Settings\n2. Go to Features \u003e MCP Servers \n3. Click \"+ Add New MCP Server\"\n4. Enter the following:\n   - Name: \"octagon-mcp\" (or your preferred name)\n   - Type: \"command\"\n   - Command: `env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp`\n\n\u003e If you are using Windows and are running into issues, try `cmd /c \"set OCTAGON_API_KEY=your-octagon-api-key \u0026\u0026 npx -y octagon-mcp\"`\n\nReplace `your-octagon-api-key` with your Octagon API key.\n\nAfter adding, refresh the MCP server list to see the new tools. The Composer Agent will automatically use Octagon MCP when appropriate, but you can explicitly request it by describing your investment research needs. Access the Composer via Command+L (Mac), select \"Agent\" next to the submit button, and enter your query.\n\n### Running on Claude Desktop\n\nTo configure Octagon MCP for Claude Desktop:\n\n1. Open Claude Desktop\n2. Go to Settings \u003e Developer \u003e Edit Config\n3. Add the following to your `claude_desktop_config.json`:\n   ```json\n   {\n     \"mcpServers\": {\n       \"octagon\": {\n         \"command\": \"env\",\n         \"args\": [\"OCTAGON_API_KEY=your-octagon-api-key\", \"npx\", \"-y\", \"octagon-mcp\"]\n       }\n     }\n   }\n   ```\n\nReplace `your-octagon-api-key` with your Octagon API key.\n\n### Running on Windsurf\n\nAdd this to your `./codeium/windsurf/model_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server-octagon\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"octagon-mcp\"],\n      \"env\": {\n        \"OCTAGON_API_KEY\": \"YOUR_API_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n### Environment Variables\n\n#### Required\n\n- `OCTAGON_API_KEY`: Your Octagon API key\n  - Required for all operations\n  - Sign up at [Octagon](https://octagonagents.com) if you don't have an API key\n\n#### Getting an API Key\n\nTo use Octagon MCP, you need to:\n\n1. Sign up for an account at [app.octagonai.co](https://app.octagonai.co)\n2. After logging in, navigate to **Settings → API Keys** \n3. Generate a new API key\n4. Use this API key in your configuration as the `OCTAGON_API_KEY` value\n\n#### Optional Configuration\n\n- `OCTAGON_API_BASE_URL`: Custom API endpoint (default: https://api.octagonagents.com/v1)\n\n## Available Tools\n\nEach tool uses a single `prompt` parameter that accepts a natural language query. Include all relevant details in your prompt.\n\n### Public Market Intelligence\n\n#### octagon-sec-agent\nExtract information from SEC filings.\n\nExample:\n```\nWhat was Apple's gross margin percentage from their latest 10-Q filing?\n```\n\n#### octagon-transcripts-agent\nAnalyze earnings call transcripts.\n\nExample:\n```\nWhat did NVIDIA's CEO say about AI chip demand in their latest earnings call?\n```\n\n#### octagon-financials-agent\nRetrieve financial metrics and ratios.\n\nExample:\n```\nCalculate the price-to-earnings ratio for Tesla over the last 4 quarters\n```\n\n#### octagon-stock-data-agent\nAccess stock market data.\n\nExample:\n```\nHow has Apple's stock performed compared to the S\u0026P 500 over the last 6 months?\n```\n\n### Private Market Intelligence\n\n#### octagon-companies-agent\nResearch private company information.\n\nExample:\n```\nWhat is the employee count and funding history for Anthropic?\n```\n\n#### octagon-funding-agent\nResearch startup funding rounds and venture capital.\n\nExample:\n```\nWhat was OpenAI's latest funding round size, valuation, and key investors?\n```\n\n#### octagon-deals-agent\nResearch M\u0026A and IPO transactions.\n\nExample:\n```\nWhat was the acquisition price when Microsoft acquired GitHub?\n```\n\n#### octagon-investors-agent\nA specialized database agent for looking up information on investors.\n\nExample:\n```\nWhat is the latest investment criteria of Insight Partners?\n```\n\n#### octagon-debts-agent\nA specialized database agent for analyzing private debts, borrowers, and lenders.\n\nExample:\n```\nList all the debt activities from borrower American Tower\n```\n\n### Additional Tools\n\n#### octagon-scraper-agent\nExtract data from any public website.\n\nExample:\n```\nExtract property prices and square footage data from zillow.com/san-francisco-ca/\n```\n\n#### octagon-deep-research-agent\nPerform comprehensive research on any topic.\n\nExample:\n```\nResearch the financial impact of Apple's privacy changes on digital advertising companies' revenue and margins\n```\n\n## Example Queries\n\n1. \"What were Amazon's revenue and net income figures in Q4 2023?\"\n2. \"Analyze Tesla's R\u0026D spending trends over the last 3 years.\"\n3. \"What guidance did NVIDIA's CEO provide regarding AI chip demand in their latest earnings call?\"\n4. \"Compare the price-to-earnings, price-to-sales, and EV/EBITDA ratios for the top 5 semiconductor companies.\"\n5. \"What was Anthropic's latest funding round size, valuation, and key investors?\"\n6. \"Extract all data fields from zillow.com/san-francisco-ca/\"\n7. \"Research the financial impact of Apple's privacy changes on digital advertising companies' revenue and margins\"\n8. \"Compile all the debt activities from lender ING Group in Q4 2024\"\n9. \"How many investments did Andreessen Horowitz make in AI startups in the last 12 months?\"\n\n## Troubleshooting\n\n1. **API Key Issues**: Ensure your Octagon API key is correctly set in the environment or config file.\n2. **Connection Issues**: Make sure the connectivity to the Octagon API is working properly.\n3. **Rate Limiting**: If you encounter rate limiting errors, reduce the frequency of your requests.\n\n## License\n\nMIT ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOctagonAI%2Foctagon-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOctagonAI%2Foctagon-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOctagonAI%2Foctagon-mcp-server/lists"}