get_build_spec
READ
Get the full build specification for a project, including all completed agent outputs.
The get_build_spec tool returns a project‘s complete set of completed agent outputs in one call. This is ideal when you need the full picture: tech stack decisions, MVP scope, UI/UX guidelines, implementation plan, and more, before starting development.
The response includes a project object with basic metadata and an agent_outputs map keyed by agent type (e.g. "tech_stack", "mvp_planner", "implementation_plan_generator"). Each value is the raw markdown output produced by that agent.
If you only need a single agent’s output, prefer get_agent_output to keep context size manageable for your AI model.
Returns an error if the project does not belong to the authenticated user or does not exist.
Only agent outputs with status completed and non-empty content are included. Pending or failed agents are omitted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
project_id
|
string
|
Required |
The UUID of the project to retrieve the build spec for.
Example: 550e8400-e29b-41d4-a716-446655440000
|
Response Example
{
"project": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "AI-powered recruitment platform",
"description": "A platform that uses AI to match startup job postings with candidates.",
"status": "completed"
},
"agent_outputs": {
"tech_stack": "## Tech Stack Recommendation
**Backend:** Elixir/Phoenix...",
"mvp_planner": "## MVP Plan
### Core Features
1. Job posting creation...",
"ui_ux_assistant": "## UI/UX Guidelines
### Design Principles...",
"implementation_plan_generator": "## Implementation Plan
### Phase 1..."
}
}Errors
| Scenario | Error Message |
|---|---|
| Project does not exist or belongs to another user |
Error: Project not found
|
Code Examples
curl -X POST https://mcp.cofounder.im/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_build_spec",
"arguments": {"project_id": "550e8400-e29b-41d4-a716-446655440000"}
}
}'
{:ok, response} =
Req.post("https://mcp.cofounder.im/mcp",
json: %{
"jsonrpc" => "2.0",
"id" => 1,
"method" => "tools/call",
"params" => %{
"name" => "get_build_spec",
"arguments" => %{"project_id" => "550e8400-e29b-41d4-a716-446655440000"}
}
},
headers: [
{"content-type", "application/json"},
{"authorization", "Bearer YOUR_API_KEY"}
]
)
response.body["result"]["content"]
|> hd()
|> Map.get("text")
|> IO.puts()
import requests
response = requests.post(
"https://mcp.cofounder.im/mcp",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY",
},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_build_spec",
"arguments": {"project_id": "550e8400-e29b-41d4-a716-446655440000"},
},
},
)
data = response.json()
print(data["result"]["content"][0]["text"])
const response = await fetch("https://mcp.cofounder.im/mcp", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer YOUR_API_KEY",
},
body: JSON.stringify({
jsonrpc: "2.0",
id: 1,
method: "tools/call",
params: {
name: "get_build_spec",
arguments: { project_id: "550e8400-e29b-41d4-a716-446655440000" },
},
}),
});
const data = await response.json();
console.log(data.result.content[0].text);
Try It
This sends a real request to your account.