MCP JSON Examples: Config Snippets and Sample Tool Calls
Developer reference with validated JSON examples for MCP configurations and tool calls. This page provides client config templates and example request/response payloads for Corcava tools—all with placeholders for secrets.
Client Configuration Examples
Claude Desktop Config
Claude Desktop Configuration
File: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
{ "mcpServers": { "corcava": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-http", "https://mcp.corcava.com" ], "env": { "CORCAVA_API_KEY": "YOUR_API_KEY_HERE" } } } }
Replace: YOUR_API_KEY_HERE with your actual Corcava API key
Cursor Config
Cursor Configuration
File: ~/.cursor/mcp.json
{ "mcpServers": { "corcava": { "url": "https://mcp.corcava.com", "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" } } } }
Replace: YOUR_API_KEY_HERE with your actual Corcava API key
Windsurf Config
Windsurf Configuration
Location: Windsurf Settings → AI → MCP Servers
{ "name": "corcava", "url": "https://mcp.corcava.com", "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" } }
Replace: YOUR_API_KEY_HERE with your actual Corcava API key
Continue Config
Continue Configuration
File: ~/.continue/config.json
{ "mcpServers": [ { "name": "corcava", "url": "https://mcp.corcava.com", "transport": "sse", "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" } } ] }
Replace: YOUR_API_KEY_HERE with your actual Corcava API key
Note: Continue uses SSE transport for remote servers
Tool Call Examples
list_tasks Tool Call
Request Example
{ "method": "tools/call", "params": { "name": "list_tasks", "arguments": { "project_id": "proj_123", "status": "open", "due_date": "this_week", "limit": 10 } } }
Response Example
{ "content": [ { "type": "text", "text": "{\"tasks\": [{\"id\": \"task_456\", \"title\": \"Implement authentication\", \"status\": \"open\", \"due_date\": \"2026-01-30\", \"assignee\": \"John Doe\", \"project_id\": \"proj_123\"}]}" } ] }
create_task Tool Call
Request Example
{ "method": "tools/call", "params": { "name": "create_task", "arguments": { "title": "Review API design", "description": "Review and provide feedback on the new API design document", "project_id": "proj_123", "due_date": "2026-02-01", "assignee": "Jane Smith", "status": "open" } } }
Response Example
{ "content": [ { "type": "text", "text": "{\"task\": {\"id\": \"task_789\", \"title\": \"Review API design\", \"status\": \"open\", \"created_at\": \"2026-01-25T10:00:00Z\"}}" } ] }
update_task Tool Call
Request Example
{ "method": "tools/call", "params": { "name": "update_task", "arguments": { "task_id": "task_456", "status": "in_progress", "assignee": "John Doe" } } }
Response Example
{ "content": [ { "type": "text", "text": "{\"task\": {\"id\": \"task_456\", \"title\": \"Implement authentication\", \"status\": \"in_progress\", \"assignee\": \"John Doe\", \"updated_at\": \"2026-01-25T10:30:00Z\"}}" } ] }
start_time_tracking Tool Call
Request Example
{ "method": "tools/call", "params": { "name": "start_time_tracking", "arguments": { "task_id": "task_456" } } }
Response Example
{ "content": [ { "type": "text", "text": "{\"status\": \"tracking\", \"task_id\": \"task_456\", \"started_at\": \"2026-01-25T10:00:00Z\"}" } ] }
Error Response Examples
401 Unauthorized
Error Response
{ "error": { "code": 401, "message": "Unauthorized", "data": { "reason": "Invalid or missing API key" } } }
403 Forbidden
Error Response
{ "error": { "code": 403, "message": "Forbidden", "data": { "reason": "API key does not have permission for this operation" } } }
Validation Error
Error Response
{ "error": { "code": 400, "message": "Validation Error", "data": { "field": "task_id", "reason": "Task ID is required" } } }
JSON Validation Notes
Common JSON Mistakes
- Trailing commas: JSON doesn't allow trailing commas in objects/arrays
- Quotes: Use double quotes for strings, not single quotes
- Escape sequences: Escape special characters in strings (e.g.,
\"for quote) - Nesting: Ensure proper bracket/brace matching
- Numbers: Don't quote numeric values
Related Resources
Config Generator
Generate config snippets
Tool Reference
Complete tool documentation
Config Troubleshooting
Fix JSON errors
MCP Architecture
Understand MCP protocol
JSON Examples for MCP
Use these validated examples to configure clients and understand tool calls