← API Reference
All Tools
account_status
READ
Get account information: credits, project count, subscription plan, and active runs.
The account_status tool provides a snapshot of the authenticated user’s account. It returns:
credits_remaining— how many credits are available for agent runssubscription_plan— current plan tier: free, basic, pro, or ultimateproject_count— total number of projects createdactive_agent_runs— any agents currently in pending, queued, or processing stateemailandusername— for confirmationmember_since— account creation date
Call this tool before running expensive agent sequences to confirm you have sufficient credits. If credits are low, use the buy_credits tool to get purchase links.
Use this tool to check credit balance before calling run_agent or rerun_agent on expensive pipelines.
Parameters
No parameters required.
Response Example
{
"email": "founder@acme.com",
"username": "janefounder",
"member_since": "2025-11-03T14:22:00Z",
"subscription_plan": "pro",
"credits_remaining": 2450,
"project_count": 3,
"active_agent_runs": [
{
"project_id": "550e8400-e29b-41d4-a716-446655440000",
"project_name": "AI recruitment platform",
"agent_type": "market_research",
"status": "processing"
}
]
}Errors
This tool has no error conditions.
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": "account_status",
"arguments": {}
}
}'
{:ok, response} =
Req.post("https://mcp.cofounder.im/mcp",
json: %{
"jsonrpc" => "2.0",
"id" => 1,
"method" => "tools/call",
"params" => %{
"name" => "account_status",
"arguments" => %{}
}
},
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": "account_status",
"arguments": {},
},
},
)
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: "account_status",
arguments: {},
},
}),
});
const data = await response.json();
console.log(data.result.content[0].text);
Try It
This sends a real request to your account.