ElevenLabs MCP Server

Instructions

Implementation Reference

• src/elevenlabs_mcp/server.py:291-303 (registration)

  Tool registration including name, description, and input schema definition.

      name="get_voiceover_history",
      description="Get voiceover job history. Optionally specify a job ID for a specific job.",
      inputSchema={
          "type": "object",
          "properties": {
              "job_id": {
                  "type": "string",
                  "description": "Optional job ID to get details for a specific job"
              }
          },
          "required": []
      }
  )

• src/elevenlabs_mcp/server.py:542-568 (handler)

  Handler function that fetches voiceover job history from database (all jobs or specific job_id), serializes to JSON, and returns as text content.

  elif name == "get_voiceover_history":
      try:
          job_id = arguments.get("job_id")
          if job_id:
              job = await self.db.get_job(job_id)
              if not job:
                  return [types.TextContent(
                      type="text",
                      text=json.dumps({"error": "Job not found"}, indent=2)
                  )]
              jobs = [job]
          else:
              jobs = await self.db.get_all_jobs()
  
          # Convert jobs to JSON
          jobs_data = [job.to_dict() for job in jobs]
          return [types.TextContent(
              type="text",
              text=json.dumps(jobs_data, indent=2)
          )]
          
      except Exception as e:
          return [types.TextContent(
              type="text",
              text=json.dumps({"error": str(e)}, indent=2)
          )]