UnlimitedTTS for Agents

비수탁형(non-custodial), 견적 우선(quote-first) 방식의 AI 에이전트용 텍스트 음성 변환(TTS) 서비스:

• @unlimitedtts/core는 실시간 x402 챌린지를 검증하고, 지출 정책을 시행하며, 민감 정보가 제거된 영수증을 저장하고, 비공개 MP3 아티팩트를 기록합니다.

• @unlimitedtts/mcp는 stdio를 통해 tts_list_voices, tts_quote, 되돌릴 수 없는 tts_synthesize 도구를 노출합니다.

• @unlimitedtts/openclaw는 MCP 서버와 unlimitedtts 에이전트 스킬을 번들로 제공합니다.

• skills/unlimitedtts는 MCP 기반 및 직접 지갑 인식 HTTP 워크플로우를 지원합니다.

구현된 v1 경로는 외부 서명(external-signature) 모드입니다. 별도의 지갑 도구가 x402 v2 PAYMENT-SIGNATURE를 생성하며, 이 코드는 시드 문구나 개인 키를 절대 받지 않습니다.

설치 및 빌드

Node.js 20 이상과 pnpm이 필요합니다.

pnpm install --frozen-lockfile
pnpm check

이 체크아웃에서 로컬 서버를 실행하세요:

pnpm --filter @unlimitedtts/mcp build
node packages/mcp/dist/cli.js

npm 배포 후 일반적인 MCP 구성:

{
  "mcpServers": {
    "unlimitedtts": {
      "command": "npx",
      "args": ["-y", "@unlimitedtts/mcp@0.1.0"],
      "env": {
        "UNLIMITEDTTS_MAX_USDC_PER_CALL": "0.10",
        "UNLIMITEDTTS_ROLLING_24H_USDC": "1.00",
        "UNLIMITEDTTS_OUTPUT_DIRECTORY": "/absolute/approved/output"
      }
    }
  }
}

OpenClaw 로컬 개발:

pnpm --filter @unlimitedtts/openclaw build
openclaw plugins install -l ./packages/openclaw
openclaw plugins enable unlimitedtts
openclaw gateway restart
openclaw plugins inspect unlimitedtts --runtime --json
openclaw plugins doctor

Related MCP server: mcp-ai-voice

결제 흐름

1. tts_list_voices는 /docs와 /tts/voices를 조회하고 결과를 5분간 캐시합니다.

2. tts_quote는 결제 없이 정확한 합성 본문을 /x402/tts로 전송하고, 반환된 PAYMENT-REQUIRED를 검증하며, 로컬 정책을 시행하고, 롤링 예산을 예약한 뒤 유효기간이 짧은 HMAC 토큰을 반환합니다.

3. 지갑은 반환된 selectedRequirement만 서명합니다.

4. tts_synthesize는 토큰, 변경되지 않은 본문 해시, 완전한 x402 v2 accepted 항목, 정확한 EVM 수취인과 금액을 검증한 다음 유료 재시도를 한 번 전송합니다.

5. 성공적인 호출에는 audio/mpeg와 PAYMENT-RESPONSE가 모두 필요합니다. 이때 예산을 확정하고, 민감 정보가 제거된 영수증을 기록하며, MP3를 모드 0600으로 원자적으로 저장하고, 구조화된 메타데이터와 MCP 오디오/리소스 콘텐츠를 반환합니다.

PAYMENT_OUTCOME_UNKNOWN은 해당 견적을 로컬 원장에 영구 격리합니다. 서버는 자동으로 두 번째 결제를 제출하거나 승인하지 않습니다.

구성

수취인 변경(rotation)은 신뢰할 수 있는 구성을 통해서만 배포되어야 합니다. 서버는 신뢰할 수 없는 챌린지로부터 허용된 수취인을 결코 알 수 없습니다.

프로덕션은 기본값으로 유지되며 Base 메인넷에 고정됩니다. 스테이징 검증을 위해 UNLIMITEDTTS_ENVIRONMENT=staging으로 설정하세요. 이 경우 https://staging-api.unlimitedtts.com, Base Sepolia(eip155:84532), 스테이징 USDC가 선택됩니다. 코어는 환경이 명시적으로 staging이 아닐 때 스테이징 오리진, 네트워크 또는 자산을 거부합니다.

범위

이 체크아웃은 이식 가능한 로컬 MCP, 외부 지갑 어댑터 계약, 에이전트 스킬, OpenClaw 패키지, 테스트 및 레지스트리 메타데이터를 구현합니다. 호스팅형 Streamable HTTP, 임시 R2 스토리지, 선불카드 방식의 합성, 그리고 구체적인 관리형 자동 서명자는 의도적으로 v1 완료 기능으로 표시되지 않습니다.

무인 자동 서명 또는 호스팅 서비스를 활성화하기 전에 필수 및 권장 업스트림 변경 사항을 참조하세요.