iflow-mcp_OctagonAI-octagon-vc-agents 0.1.6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/.gitignore +11 -0
  2. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/.python-version +1 -0
  3. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/3081_process.log +3 -0
  4. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/Dockerfile +27 -0
  5. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/LICENSE +21 -0
  6. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/MANIFEST.in +7 -0
  7. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/PKG-INFO +230 -0
  8. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/README.md +194 -0
  9. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/language.json +1 -0
  10. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/package_name +1 -0
  11. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/push_info.json +5 -0
  12. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/pyproject.toml +80 -0
  13. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/smithery.yaml +23 -0
  14. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/__init__.py +9 -0
  15. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/__main__.py +38 -0
  16. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/agent_registrar.py +71 -0
  17. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/cli.py +160 -0
  18. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/client.py +25 -0
  19. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/alfred_lin.md +402 -0
  20. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/bill_gurley.md +378 -0
  21. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/fred_wilson.md +415 -0
  22. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/josh_kopelman.md +396 -0
  23. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/keith_rabois.md +391 -0
  24. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/marc_andreessen.md +422 -0
  25. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/peter_thiel.md +405 -0
  26. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/investors/reid_hoffman.md +374 -0
  27. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/openai_agents.py +161 -0
  28. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/server.py +33 -0
  29. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/src/octagon_vc_agents/vc_agents.py +43 -0
  30. iflow_mcp_octagonai_octagon_vc_agents-0.1.6/uv.lock +745 -0
@@ -0,0 +1,11 @@
1
+ # Python-generated files
2
+ __pycache__/
3
+ *.py[oc]
4
+ build/
5
+ dist/
6
+ wheels/
7
+ *.egg-info
8
+
9
+ # Virtual environments
10
+ .venv
11
+ .cursor*
@@ -0,0 +1,3 @@
1
+ [2026-02-05] [完成] 阅读代码: 项目是Python MCP服务端项目,使用FastMCP实现,提供8个VC投资代理人工具
2
+ [2026-02-05] [完成] 本地测试: 测试成功,检测到8个工具,环境变量: OCTAGON_API_KEY=test_key, OPENAI_API_KEY=test_key
3
+ [2026-02-05] [完成] 推送分支: iflow分支已成功推送到远程仓库
@@ -0,0 +1,27 @@
1
+ # Generated by https://smithery.ai. See: https://smithery.ai/docs/config#dockerfile
2
+ FROM python:3.11-slim
3
+
4
+ # set working directory
5
+ WORKDIR /app
6
+
7
+ # install build dependencies
8
+ RUN apt-get update && apt-get install -y gcc && rm -rf /var/lib/apt/lists/*
9
+
10
+ # copy project files
11
+ COPY . /app
12
+
13
+ # upgrade pip
14
+ RUN pip install --no-cache-dir --upgrade pip
15
+
16
+ # install project dependencies using hatchling build system
17
+ RUN pip install --no-cache-dir -e .
18
+
19
+ # expose port if using SSE transport (optional)
20
+ EXPOSE 5173
21
+
22
+ # set environment variables (these should be overridden at runtime)
23
+ ENV OPENAI_API_KEY="your-openai-api-key"
24
+ ENV OCTAGON_API_KEY="your-octagon-api-key"
25
+
26
+ # default command
27
+ CMD ["octagon-vc-agents-mcp-server"]
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Octagon AI, Inc.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,7 @@
1
+ include LICENSE
2
+ include README.md
3
+ include pyproject.toml
4
+ recursive-include src/octagon_vc_agents/investors *.md
5
+ recursive-include src/octagon_vc_agents *.py
6
+ recursive-exclude * __pycache__
7
+ recursive-exclude * *.py[cod]
@@ -0,0 +1,230 @@
1
+ Metadata-Version: 2.4
2
+ Name: iflow-mcp_OctagonAI-octagon-vc-agents
3
+ Version: 0.1.6
4
+ Summary: MCP server that runs AI-driven venture capitalist agents, enriched by Octagon Private Markets' real-time intelligence
5
+ Project-URL: Homepage, https://github.com/OctagonAI/octagon-vc-agents
6
+ Project-URL: Documentation, https://docs.octagonagents.com
7
+ Project-URL: Repository, https://github.com/OctagonAI/octagon-vc-agents.git
8
+ Project-URL: Issues, https://github.com/OctagonAI/octagon-vc-agents/issues
9
+ Author-email: Octagon AI <support@octagonagents.com>
10
+ License-Expression: MIT
11
+ License-File: LICENSE
12
+ Keywords: agents,ai,investment,startup,venture capital
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Topic :: Office/Business :: Financial :: Investment
19
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
20
+ Requires-Python: >=3.11
21
+ Requires-Dist: mcp
22
+ Requires-Dist: openai
23
+ Requires-Dist: openai-agents
24
+ Requires-Dist: pydantic
25
+ Requires-Dist: requests
26
+ Requires-Dist: rich
27
+ Requires-Dist: typer
28
+ Requires-Dist: uvicorn
29
+ Provides-Extra: dev
30
+ Requires-Dist: black; extra == 'dev'
31
+ Requires-Dist: ipython>=9.0.2; extra == 'dev'
32
+ Requires-Dist: isort; extra == 'dev'
33
+ Requires-Dist: pytest; extra == 'dev'
34
+ Requires-Dist: pytest-cov; extra == 'dev'
35
+ Description-Content-Type: text/markdown
36
+
37
+ # Octagon VC Agents
38
+
39
+ [![smithery badge](https://smithery.ai/badge/@OctagonAI/octagon-vc-agents)](https://smithery.ai/server/@OctagonAI/octagon-vc-agents)
40
+
41
+ An MCP server that runs AI-driven venture capitalist agents (Fred Wilson, Peter Thiel, etc.), whose thinking is continuously enriched by Octagon Private Markets' real-time deals, valuations, and deep research intelligence. Use it to spin up programmable "VC brains" for pitch feedback, diligence simulations, term sheet negotiations, and more.
42
+
43
+ <!-- Display at 60% wide and keep the aspect ratio -->
44
+ <img src="https://docs.octagonagents.com/octagon-vc-agents.png"
45
+ alt="Octagon VC Agents"
46
+ width="60%" />
47
+
48
+ ## Try Demo in ChatGPT
49
+ VC Agents are also fully integrated them in ChatGPT with a demo Octagon API key. Give them a try here:
50
+ <a href="https://chatgpt.com/g/g-680c1eddd1448191bb4ed7e09485270f-vc-agents" target="_blank" rel="noopener noreferrer">VC Agents GPT</a>
51
+
52
+
53
+ ## Octagon VC Agents
54
+
55
+ These are AI-powered simulations inspired by notable venture capitalists. These personas are not affiliated with or endorsed by the actual individuals.
56
+
57
+ | VC Agent Name | Description |
58
+ |------------|-------------|
59
+ | [`octagon-marc-andreessen-agent`](src/octagon_vc_agents/investors/marc_andreessen.md) | Simulation of the tech-optimist investor known for "software eating the world" thesis and bold technology bets |
60
+ | [`octagon-peter-thiel-agent`](src/octagon_vc_agents/investors/peter_thiel.md) | Simulation of the venture capitalist & 'Zero to One' author who analyzes investments through the lens of monopoly theory and contrarian thinking |
61
+ | [`octagon-reid-hoffman-agent`](src/octagon_vc_agents/investors/reid_hoffman.md) | Simulation of the LinkedIn founder-turned-investor known for network-effect businesses and blitzscaling philosophy |
62
+ | [`octagon-keith-rabois-agent`](src/octagon_vc_agents/investors/keith_rabois.md) | Simulation of the operator-investor known for spotting exceptional talent and operational excellence |
63
+ | [`octagon-bill-gurley-agent`](src/octagon_vc_agents/investors/bill_gurley.md) | Simulation of the analytical investor known for marketplace expertise and detailed market analysis |
64
+ | [`octagon-fred-wilson-agent`](src/octagon_vc_agents/investors/fred_wilson.md) | Simulation of the USV co-founder & veteran early-stage investor focused on community-driven networks and founder-first philosophies |
65
+ | [`octagon-josh-kopelman-agent`](src/octagon_vc_agents/investors/josh_kopelman.md) | Simulation of the founder-friendly investor focused on seed-stage companies and founder development |
66
+ | [`octagon-alfred-lin-agent`](src/octagon_vc_agents/investors/alfred_lin.md) | Simulation of the operator-turned-investor known for consumer businesses and organizational scaling |
67
+
68
+ ## Example Prompts
69
+
70
+ | What you want from the agents | Copy-and-paste prompt |
71
+ |-------------------------------|-----------------------|
72
+ | Deal critique | Ask `@octagon-marc-andreessen-agent` and `@octagon-reid-hoffman-agent` to evaluate {company website}'s latest funding round. Provide a detailed comparative table from their points of view. |
73
+ | Qualify investor fit before the call | `@octagon-alfred-lin-agent` You're vetting my pre-seed startup: {one-sentence pitch}. In {deck.pdf}, you'll find our vision, team, and WAU chart. Give me a "meet/pass" decision and list the three metrics I should strengthen most before your partner vote on Monday. |
74
+ | Thesis & metrics reality-check | `@octagon-reid-hoffman-agent` Here's our 10-slide deck and dashboard ({docs}). We currently have {X} weekly active users, {Y}% MoM WAU growth, and {Z}% retention over 8 weeks. Using your 14-day diligence lens, list the biggest metric gaps that would prevent you from issuing a term sheet, and suggest how we could close them within one quarter. |
75
+ | Portfolio-intro mapping – warm leads for the next round | `@octagon-fred-wilson-agent` Based on your current portfolio in {data} and our focus (outlined in the one-pager below), identify four portfolio CEOs who could become design partners. For each CEO, draft a first-contact email from me that highlights mutual value. |
76
+
77
+ ## Prerequisites
78
+
79
+ To use Octagon VC Agents, you will need **two API keys**:
80
+ - An **Octagon API key** (for access to Octagon Private Markets data)
81
+ - An **OpenAI API key** (for AI-powered analysis)
82
+
83
+ ### Get Your Octagon API Key
84
+
85
+ To use VC Agents, you need to:
86
+
87
+ 1. Sign up for a free account at [Octagon](https://app.octagonai.co/signup/?redirectToAfterSignup=https://app.octagonai.co/api-keys)
88
+ 2. After logging in, from left menu, navigate to **API Keys**
89
+ 3. Generate a new API key
90
+ 4. Use this API key in your configuration as the `OCTAGON_API_KEY` value
91
+
92
+ ### Get Your OpenAI API Key
93
+
94
+ You also need an OpenAI API key to enable AI-powered features:
95
+
96
+ 1. Sign up or log in at [OpenAI](https://platform.openai.com/signup)
97
+ 2. Go to [API Keys](https://platform.openai.com/api-keys)
98
+ 3. Create a new API key
99
+ 4. Use this API key in your configuration as the `OPENAI_API_KEY` value
100
+
101
+ ### Install pipx
102
+
103
+ To use Octagon VC Agents, you need [pipx](https://pypa.github.io/pipx/), a tool for installing and running Python applications in isolated environments.
104
+
105
+ #### On macOS
106
+ Install pipx using Homebrew (recommended):
107
+ ```bash
108
+ brew install pipx
109
+ pipx ensurepath
110
+ ```
111
+ Or with pip:
112
+ ```bash
113
+ python3 -m pip install --user pipx
114
+ python3 -m pipx ensurepath
115
+ ```
116
+
117
+ #### On Windows
118
+ Install pipx using pip:
119
+ ```powershell
120
+ python -m pip install --user pipx
121
+ python -m pipx ensurepath
122
+ ```
123
+ After installation, restart your terminal so that the `pipx` command is available.
124
+
125
+
126
+ ## Installation
127
+
128
+ ### Running on Claude Desktop
129
+
130
+ To configure Octagon VC Agents for Claude Desktop:
131
+
132
+ 1. Open Claude Desktop
133
+ 2. Go to Settings > Developer > Edit Config
134
+ 3. Add the following to your `claude_desktop_config.json` (Replace `YOUR_OCTAGON_API_KEY_HERE` with your Octagon API key and `YOUR_OPENAI_API_KEY_HERE` with your OpenAI API key):
135
+ ```json
136
+ {
137
+ "mcpServers": {
138
+ "octagon-vc-agents": {
139
+ "command": "pipx",
140
+ "args": ["run", "--pip-args=\"--no-cache-dir\"", "octagon-vc-agents", "run"],
141
+ "env": {
142
+ "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
143
+ "OCTAGON_API_KEY": "YOUR_OCTAGON_API_KEY_HERE"
144
+ }
145
+ }
146
+ }
147
+ }
148
+ ```
149
+ 4. Restart Claude for the changes to take effect
150
+
151
+
152
+
153
+ ### Running on Cursor
154
+
155
+ Configuring Cursor Desktop 🖥️
156
+ Note: Requires Cursor version 0.45.6+
157
+
158
+ To configure Octagon VC Agents in Cursor:
159
+
160
+ 1. Open Cursor Settings
161
+ 2. Go to Features > MCP Servers
162
+ 3. Click "+ Add New MCP Server"
163
+ 4. Enter the following:
164
+ - Name: "octagon-mcp" (or your preferred name)
165
+ - Type: "command"
166
+ - Command: `env OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE pipx run --pip-args="--no-cache-dir" octagon-vc-agents run`
167
+
168
+ > If you are using Windows and are running into issues, try `cmd /c "set OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE && set OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE && pipx run --pip-args='--no-cache-dir' octagon-vc-agents run"`
169
+
170
+ Replace `YOUR_OCTAGON_API_KEY_HERE` with your Octagon API key and `YOUR_OPENAI_API_KEY_HERE` with your OpenAI API key.
171
+
172
+ After adding, refresh the MCP server list to see the new tools. The Composer Agent will automatically use VC Agents 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.
173
+
174
+
175
+ ### Running on Windsurf
176
+
177
+ Add this to your `./codeium/windsurf/model_config.json`:
178
+
179
+ ```json
180
+ {
181
+ "mcpServers": {
182
+ "octagon-vc-agents": {
183
+ "command": "pipx",
184
+ "args": ["run", "--pip-args=\"--no-cache-dir\"", "octagon-vc-agents", "run"],
185
+ "env": {
186
+ "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
187
+ "OCTAGON_API_KEY": "YOUR_OCTAGON_API_KEY_HERE"
188
+ }
189
+ }
190
+ }
191
+ }
192
+ ```
193
+
194
+ ### Running with pipx
195
+
196
+ ```bash
197
+ env OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE pipx run --pip-args="--no-cache-dir" octagon-vc-agents run
198
+ ```
199
+
200
+ ### Manual Installation
201
+
202
+ ```bash
203
+ pip install octagon-vc-agents
204
+ ```
205
+
206
+ ## Implementation Details
207
+
208
+ ### Persona Configuration
209
+
210
+ Investor personas are defined through markdown files containing:
211
+ - Investment philosophy
212
+ - Psychological profile
213
+ - Historical track record
214
+ - Decision-making patterns
215
+ - Communication style preferences
216
+
217
+ ### Customization Options
218
+
219
+ 1. Add new investor personas by creating markdown profiles
220
+ 2. Implement custom interaction patterns between personas
221
+ 3. Enhance orchestration logic for complex multi-perspective analysis
222
+
223
+
224
+ ## Documentation
225
+
226
+ For detailed information about Octagon Agents, including setup guides, API reference, and best practices, visit our [documentation](https://docs.octagonagents.com).
227
+
228
+ ## License
229
+ MIT
230
+
@@ -0,0 +1,194 @@
1
+ # Octagon VC Agents
2
+
3
+ [![smithery badge](https://smithery.ai/badge/@OctagonAI/octagon-vc-agents)](https://smithery.ai/server/@OctagonAI/octagon-vc-agents)
4
+
5
+ An MCP server that runs AI-driven venture capitalist agents (Fred Wilson, Peter Thiel, etc.), whose thinking is continuously enriched by Octagon Private Markets' real-time deals, valuations, and deep research intelligence. Use it to spin up programmable "VC brains" for pitch feedback, diligence simulations, term sheet negotiations, and more.
6
+
7
+ <!-- Display at 60% wide and keep the aspect ratio -->
8
+ <img src="https://docs.octagonagents.com/octagon-vc-agents.png"
9
+ alt="Octagon VC Agents"
10
+ width="60%" />
11
+
12
+ ## Try Demo in ChatGPT
13
+ VC Agents are also fully integrated them in ChatGPT with a demo Octagon API key. Give them a try here:
14
+ <a href="https://chatgpt.com/g/g-680c1eddd1448191bb4ed7e09485270f-vc-agents" target="_blank" rel="noopener noreferrer">VC Agents GPT</a>
15
+
16
+
17
+ ## Octagon VC Agents
18
+
19
+ These are AI-powered simulations inspired by notable venture capitalists. These personas are not affiliated with or endorsed by the actual individuals.
20
+
21
+ | VC Agent Name | Description |
22
+ |------------|-------------|
23
+ | [`octagon-marc-andreessen-agent`](src/octagon_vc_agents/investors/marc_andreessen.md) | Simulation of the tech-optimist investor known for "software eating the world" thesis and bold technology bets |
24
+ | [`octagon-peter-thiel-agent`](src/octagon_vc_agents/investors/peter_thiel.md) | Simulation of the venture capitalist & 'Zero to One' author who analyzes investments through the lens of monopoly theory and contrarian thinking |
25
+ | [`octagon-reid-hoffman-agent`](src/octagon_vc_agents/investors/reid_hoffman.md) | Simulation of the LinkedIn founder-turned-investor known for network-effect businesses and blitzscaling philosophy |
26
+ | [`octagon-keith-rabois-agent`](src/octagon_vc_agents/investors/keith_rabois.md) | Simulation of the operator-investor known for spotting exceptional talent and operational excellence |
27
+ | [`octagon-bill-gurley-agent`](src/octagon_vc_agents/investors/bill_gurley.md) | Simulation of the analytical investor known for marketplace expertise and detailed market analysis |
28
+ | [`octagon-fred-wilson-agent`](src/octagon_vc_agents/investors/fred_wilson.md) | Simulation of the USV co-founder & veteran early-stage investor focused on community-driven networks and founder-first philosophies |
29
+ | [`octagon-josh-kopelman-agent`](src/octagon_vc_agents/investors/josh_kopelman.md) | Simulation of the founder-friendly investor focused on seed-stage companies and founder development |
30
+ | [`octagon-alfred-lin-agent`](src/octagon_vc_agents/investors/alfred_lin.md) | Simulation of the operator-turned-investor known for consumer businesses and organizational scaling |
31
+
32
+ ## Example Prompts
33
+
34
+ | What you want from the agents | Copy-and-paste prompt |
35
+ |-------------------------------|-----------------------|
36
+ | Deal critique | Ask `@octagon-marc-andreessen-agent` and `@octagon-reid-hoffman-agent` to evaluate {company website}'s latest funding round. Provide a detailed comparative table from their points of view. |
37
+ | Qualify investor fit before the call | `@octagon-alfred-lin-agent` You're vetting my pre-seed startup: {one-sentence pitch}. In {deck.pdf}, you'll find our vision, team, and WAU chart. Give me a "meet/pass" decision and list the three metrics I should strengthen most before your partner vote on Monday. |
38
+ | Thesis & metrics reality-check | `@octagon-reid-hoffman-agent` Here's our 10-slide deck and dashboard ({docs}). We currently have {X} weekly active users, {Y}% MoM WAU growth, and {Z}% retention over 8 weeks. Using your 14-day diligence lens, list the biggest metric gaps that would prevent you from issuing a term sheet, and suggest how we could close them within one quarter. |
39
+ | Portfolio-intro mapping – warm leads for the next round | `@octagon-fred-wilson-agent` Based on your current portfolio in {data} and our focus (outlined in the one-pager below), identify four portfolio CEOs who could become design partners. For each CEO, draft a first-contact email from me that highlights mutual value. |
40
+
41
+ ## Prerequisites
42
+
43
+ To use Octagon VC Agents, you will need **two API keys**:
44
+ - An **Octagon API key** (for access to Octagon Private Markets data)
45
+ - An **OpenAI API key** (for AI-powered analysis)
46
+
47
+ ### Get Your Octagon API Key
48
+
49
+ To use VC Agents, you need to:
50
+
51
+ 1. Sign up for a free account at [Octagon](https://app.octagonai.co/signup/?redirectToAfterSignup=https://app.octagonai.co/api-keys)
52
+ 2. After logging in, from left menu, navigate to **API Keys**
53
+ 3. Generate a new API key
54
+ 4. Use this API key in your configuration as the `OCTAGON_API_KEY` value
55
+
56
+ ### Get Your OpenAI API Key
57
+
58
+ You also need an OpenAI API key to enable AI-powered features:
59
+
60
+ 1. Sign up or log in at [OpenAI](https://platform.openai.com/signup)
61
+ 2. Go to [API Keys](https://platform.openai.com/api-keys)
62
+ 3. Create a new API key
63
+ 4. Use this API key in your configuration as the `OPENAI_API_KEY` value
64
+
65
+ ### Install pipx
66
+
67
+ To use Octagon VC Agents, you need [pipx](https://pypa.github.io/pipx/), a tool for installing and running Python applications in isolated environments.
68
+
69
+ #### On macOS
70
+ Install pipx using Homebrew (recommended):
71
+ ```bash
72
+ brew install pipx
73
+ pipx ensurepath
74
+ ```
75
+ Or with pip:
76
+ ```bash
77
+ python3 -m pip install --user pipx
78
+ python3 -m pipx ensurepath
79
+ ```
80
+
81
+ #### On Windows
82
+ Install pipx using pip:
83
+ ```powershell
84
+ python -m pip install --user pipx
85
+ python -m pipx ensurepath
86
+ ```
87
+ After installation, restart your terminal so that the `pipx` command is available.
88
+
89
+
90
+ ## Installation
91
+
92
+ ### Running on Claude Desktop
93
+
94
+ To configure Octagon VC Agents for Claude Desktop:
95
+
96
+ 1. Open Claude Desktop
97
+ 2. Go to Settings > Developer > Edit Config
98
+ 3. Add the following to your `claude_desktop_config.json` (Replace `YOUR_OCTAGON_API_KEY_HERE` with your Octagon API key and `YOUR_OPENAI_API_KEY_HERE` with your OpenAI API key):
99
+ ```json
100
+ {
101
+ "mcpServers": {
102
+ "octagon-vc-agents": {
103
+ "command": "pipx",
104
+ "args": ["run", "--pip-args=\"--no-cache-dir\"", "octagon-vc-agents", "run"],
105
+ "env": {
106
+ "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
107
+ "OCTAGON_API_KEY": "YOUR_OCTAGON_API_KEY_HERE"
108
+ }
109
+ }
110
+ }
111
+ }
112
+ ```
113
+ 4. Restart Claude for the changes to take effect
114
+
115
+
116
+
117
+ ### Running on Cursor
118
+
119
+ Configuring Cursor Desktop 🖥️
120
+ Note: Requires Cursor version 0.45.6+
121
+
122
+ To configure Octagon VC Agents in Cursor:
123
+
124
+ 1. Open Cursor Settings
125
+ 2. Go to Features > MCP Servers
126
+ 3. Click "+ Add New MCP Server"
127
+ 4. Enter the following:
128
+ - Name: "octagon-mcp" (or your preferred name)
129
+ - Type: "command"
130
+ - Command: `env OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE pipx run --pip-args="--no-cache-dir" octagon-vc-agents run`
131
+
132
+ > If you are using Windows and are running into issues, try `cmd /c "set OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE && set OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE && pipx run --pip-args='--no-cache-dir' octagon-vc-agents run"`
133
+
134
+ Replace `YOUR_OCTAGON_API_KEY_HERE` with your Octagon API key and `YOUR_OPENAI_API_KEY_HERE` with your OpenAI API key.
135
+
136
+ After adding, refresh the MCP server list to see the new tools. The Composer Agent will automatically use VC Agents 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.
137
+
138
+
139
+ ### Running on Windsurf
140
+
141
+ Add this to your `./codeium/windsurf/model_config.json`:
142
+
143
+ ```json
144
+ {
145
+ "mcpServers": {
146
+ "octagon-vc-agents": {
147
+ "command": "pipx",
148
+ "args": ["run", "--pip-args=\"--no-cache-dir\"", "octagon-vc-agents", "run"],
149
+ "env": {
150
+ "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
151
+ "OCTAGON_API_KEY": "YOUR_OCTAGON_API_KEY_HERE"
152
+ }
153
+ }
154
+ }
155
+ }
156
+ ```
157
+
158
+ ### Running with pipx
159
+
160
+ ```bash
161
+ env OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE pipx run --pip-args="--no-cache-dir" octagon-vc-agents run
162
+ ```
163
+
164
+ ### Manual Installation
165
+
166
+ ```bash
167
+ pip install octagon-vc-agents
168
+ ```
169
+
170
+ ## Implementation Details
171
+
172
+ ### Persona Configuration
173
+
174
+ Investor personas are defined through markdown files containing:
175
+ - Investment philosophy
176
+ - Psychological profile
177
+ - Historical track record
178
+ - Decision-making patterns
179
+ - Communication style preferences
180
+
181
+ ### Customization Options
182
+
183
+ 1. Add new investor personas by creating markdown profiles
184
+ 2. Implement custom interaction patterns between personas
185
+ 3. Enhance orchestration logic for complex multi-perspective analysis
186
+
187
+
188
+ ## Documentation
189
+
190
+ For detailed information about Octagon Agents, including setup guides, API reference, and best practices, visit our [documentation](https://docs.octagonagents.com).
191
+
192
+ ## License
193
+ MIT
194
+
@@ -0,0 +1 @@
1
+ iflow-mcp_OctagonAI-octagon-vc-agents
@@ -0,0 +1,5 @@
1
+ {
2
+ "push_platform": "github",
3
+ "fork_url": "https://github.com/iflow-mcp/octagonai-octagon-vc-agents",
4
+ "fork_branch": "iflow"
5
+ }
@@ -0,0 +1,80 @@
1
+ [project]
2
+ name = "iflow-mcp_OctagonAI-octagon-vc-agents"
3
+ version = "0.1.6"
4
+ description = "MCP server that runs AI-driven venture capitalist agents, enriched by Octagon Private Markets' real-time intelligence"
5
+ readme = "README.md"
6
+ requires-python = ">=3.11"
7
+ license = "MIT"
8
+ authors = [
9
+ { name = "Octagon AI", email = "support@octagonagents.com" }
10
+ ]
11
+ keywords = ["venture capital", "ai", "agents", "investment", "startup"]
12
+ classifiers = [
13
+ "Development Status :: 4 - Beta",
14
+ "Intended Audience :: Developers",
15
+ "License :: OSI Approved :: MIT License",
16
+ "Programming Language :: Python :: 3",
17
+ "Programming Language :: Python :: 3.11",
18
+ "Topic :: Software Development :: Libraries :: Python Modules",
19
+ "Topic :: Office/Business :: Financial :: Investment",
20
+ ]
21
+ dependencies = [
22
+ "mcp",
23
+ "pydantic",
24
+ "openai",
25
+ "openai-agents",
26
+ "typer",
27
+ "rich",
28
+ "uvicorn",
29
+ "requests",
30
+ ]
31
+
32
+ [project.urls]
33
+ Homepage = "https://github.com/OctagonAI/octagon-vc-agents"
34
+ Documentation = "https://docs.octagonagents.com"
35
+ Repository = "https://github.com/OctagonAI/octagon-vc-agents.git"
36
+ Issues = "https://github.com/OctagonAI/octagon-vc-agents/issues"
37
+
38
+ [project.scripts]
39
+ octagon_vc_agents = "octagon_vc_agents.cli:main"
40
+
41
+ [build-system]
42
+ requires = ["hatchling"]
43
+ build-backend = "hatchling.build"
44
+
45
+ [tool.hatch.build.targets.wheel]
46
+ packages = ["src/octagon_vc_agents"]
47
+
48
+ [tool.hatch.metadata]
49
+ allow-direct-references = true
50
+
51
+ [project.optional-dependencies]
52
+ dev = ["ipython>=9.0.2", "black", "isort", "pytest", "pytest-cov"]
53
+
54
+ [tool.isort]
55
+ profile = "black"
56
+ line_length = 100
57
+ multi_line_output = 3
58
+
59
+ [tool.black]
60
+ line-length = 100
61
+ target-version = ["py39"]
62
+ skip-magic-trailing-comma = true
63
+ include = '\.pyi?$'
64
+ force-exclude = '''
65
+ /(
66
+ \.git
67
+ | \.hg
68
+ | \.mypy_cache
69
+ | \.pytest_cache
70
+ | \.tox
71
+ | \.venv
72
+ | _build
73
+ | buck-out
74
+ | build
75
+ | dist
76
+ | migrations
77
+ | fixture
78
+ | fixtures
79
+ )/
80
+ '''
@@ -0,0 +1,23 @@
1
+ startCommand:
2
+ type: stdio
3
+ configSchema:
4
+ type: object
5
+ required:
6
+ - openaiApiKey
7
+ - octagonApiKey
8
+ properties:
9
+ openaiApiKey:
10
+ type: string
11
+ description: Your OpenAI API key.
12
+ octagonApiKey:
13
+ type: string
14
+ description: Your Octagon API key (get a free one at https://app.octagonai.co/signup)
15
+ commandFunction: |
16
+ (config) => ({
17
+ command: 'octagon-vc-agents-mcp-server',
18
+ args: [],
19
+ env: {
20
+ OPENAI_API_KEY: config.openaiApiKey,
21
+ OCTAGON_API_KEY: config.octagonApiKey,
22
+ }
23
+ })
@@ -0,0 +1,9 @@
1
+ """
2
+ Octagon VC Agents - AI-driven venture capitalist agents powered by Octagon Private Markets
3
+ """
4
+
5
+ __version__ = "0.1.0"
6
+
7
+ from .cli import main
8
+
9
+ __all__ = ["main"]
@@ -0,0 +1,38 @@
1
+ """
2
+ Main entry point for the Octagon octagon-vc-agents.
3
+
4
+ This module provides the main entry point for running the MCP server.
5
+ """
6
+
7
+ import os
8
+ import sys
9
+
10
+ from octagon_vc_agents.server import mcp
11
+
12
+
13
+ def main() -> None:
14
+ """Run the MCP server."""
15
+ # Check if the OpenAI API key is set
16
+ if not os.environ.get("OPENAI_API_KEY"):
17
+ print("Error: OPENAI_API_KEY environment variable is not set.")
18
+ print("Please set it before running the server.")
19
+ sys.exit(1)
20
+
21
+ # Check if the Octagon API key is set
22
+ if not os.environ.get("OCTAGON_API_KEY"):
23
+ print("Error: OCTAGON_API_KEY environment variable is not set.")
24
+ print("Obtain your API key at https://app.octagonai.co/signup")
25
+ print("Please set it before running the server.")
26
+ sys.exit(1)
27
+
28
+ # Get the transport from environment variables or use default
29
+ transport = os.environ.get("MCP_TRANSPORT", "stdio")
30
+
31
+ print(f"Starting OpenAI Agents MCP server with {transport} transport")
32
+
33
+ # Run the server using the FastMCP's run method
34
+ mcp.run(transport=transport)
35
+
36
+
37
+ if __name__ == "__main__":
38
+ main()