tts
Convert text to speech to generate MP3 audio files for accessibility, content creation, or multimedia projects using customizable voice options.
Instructions
Convert text to speech (MP3) ($0.002)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| voice | No | alloy |
Implementation Reference
- index.js:25-25 (registration)The "tts" tool is defined in the TOOLS array with its schema, endpoint, and pricing.
{ name: 'tts', description: 'Convert text to speech (MP3)', inputSchema: { type: 'object', properties: { text: { type: 'string' }, voice: { type: 'string', default: 'alloy' } }, required: ['text'] }, endpoint: '/tts', price: '$0.002' }, - index.js:94-115 (handler)The request handler for tools dynamically finds the tool definition and delegates execution to the callTool function.
server.setRequestHandler(CallToolRequestSchema, async (request) => { const { name, arguments: args } = request.params; if (!API_KEY) { return { content: [{ type: 'text', text: 'Error: ITERATOOLS_API_KEY environment variable not set. Get a key at https://iteratools.com' }], isError: true, }; } const tool = TOOLS.find(t => t.name === name); if (!tool) { return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true }; } try { const result = await callTool(tool.endpoint, args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; } catch (err) { return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true }; } }); - index.js:50-79 (helper)The callTool helper function performs the network request to the IteraTools API based on the tool's configured endpoint.
async function callTool(endpoint, params) { const fetch = (await import('node-fetch')).default; const isGet = ['GET'].includes((TOOLS.find(t => t.endpoint === endpoint) || {}).method); const url = isGet ? `${BASE_URL}${endpoint}?${new URLSearchParams(params)}` : `${BASE_URL}${endpoint}`; const res = await fetch(url, { method: isGet ? 'GET' : 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${API_KEY}`, }, body: isGet ? undefined : JSON.stringify(params), }); const text = await res.text(); let data; try { data = JSON.parse(text); } catch { data = { raw: text }; } if (!res.ok) { if (res.status === 402) { throw new Error(`Insufficient credits. Add credits at https://iteratools.com. Cost: ${TOOLS.find(t=>t.endpoint===endpoint)?.price || 'see docs'}`); } throw new Error(`API error ${res.status}: ${text.substring(0, 200)}`); } return data; }