execute_service
Execute marketplace services like AI review or web scraping to automate quality assurance. Provide service ID and input parameters; requires API key.
Instructions
Execute a service on the AgentDesk marketplace. Requires an AgentDesk API key for authentication. Pass service-specific input parameters.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| service_id | Yes | Service ID to execute (e.g., "review", "web_scrape", "realtime_jp", "pdf_generate", "summarize", "classify") | |
| input | Yes | Service-specific input parameters | |
| api_key | No | BYOK: Your Anthropic API key (for AI-powered services like review) |
Implementation Reference
- src/index.ts:115-147 (registration)Registration of the 'execute_service' tool on the MCP server via server.tool(), defining its name, description, input schema, and handler.
server.tool( 'execute_service', 'Execute a service on the AgentDesk marketplace. Requires an AgentDesk API key for authentication. Pass service-specific input parameters.', { service_id: z.string().describe('Service ID to execute (e.g., "review", "web_scrape", "realtime_jp", "pdf_generate", "summarize", "classify")'), input: z.record(z.unknown()).describe('Service-specific input parameters'), api_key: z.string().optional().describe('BYOK: Your Anthropic API key (for AI-powered services like review)'), }, safeAsyncTool(async ({ service_id, input, api_key }) => { const agentdeskKey = process.env.AGENTDESK_API_KEY if (!agentdeskKey) { throw new Error('AGENTDESK_API_KEY environment variable is required for service execution.') } const body: Record<string, unknown> = { input } if (api_key) body.api_key = api_key const res = await fetch(`${AGENTDESK_API}/api/v1/services/${encodeURIComponent(service_id)}/execute`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${agentdeskKey}`, }, body: JSON.stringify(body), }) if (!res.ok) { const errorBody = await res.text() throw new Error(`API error ${res.status}: ${errorBody}`) } return await res.json() }) ) - src/index.ts:118-122 (schema)Input schema for execute_service using Zod: service_id (string), input (record of unknown), and optional api_key.
{ service_id: z.string().describe('Service ID to execute (e.g., "review", "web_scrape", "realtime_jp", "pdf_generate", "summarize", "classify")'), input: z.record(z.unknown()).describe('Service-specific input parameters'), api_key: z.string().optional().describe('BYOK: Your Anthropic API key (for AI-powered services like review)'), }, - src/index.ts:123-146 (handler)Handler function for execute_service: reads AGENTDESK_API_KEY env var, POSTs to AgentDesk API with service_id and input, returns JSON result.
safeAsyncTool(async ({ service_id, input, api_key }) => { const agentdeskKey = process.env.AGENTDESK_API_KEY if (!agentdeskKey) { throw new Error('AGENTDESK_API_KEY environment variable is required for service execution.') } const body: Record<string, unknown> = { input } if (api_key) body.api_key = api_key const res = await fetch(`${AGENTDESK_API}/api/v1/services/${encodeURIComponent(service_id)}/execute`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${agentdeskKey}`, }, body: JSON.stringify(body), }) if (!res.ok) { const errorBody = await res.text() throw new Error(`API error ${res.status}: ${errorBody}`) } return await res.json() }) - src/index.ts:22-38 (helper)safeAsyncTool helper that wraps handler functions with MCP-compliant error handling (catches errors and returns isError response).
function safeAsyncTool<T>( fn: (args: T) => Promise<string | object> ): (args: T) => Promise<{ content: { type: 'text'; text: string }[]; isError?: boolean }> { return async (args: T) => { try { const result = await fn(args) const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2) return { content: [{ type: 'text' as const, text }] } } catch (e) { const message = e instanceof Error ? e.message : String(e) return { content: [{ type: 'text' as const, text: `Error: ${message}` }], isError: true, } } } }