> ## Documentation Index
> Fetch the complete documentation index at: https://arcpay-somnia.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Run a developer tool by URL

> Runs a tool with query-string arguments. Text tools return text/plain; JSON tools return application/json.



## OpenAPI

````yaml /apps/frontend/public/openapi.json get /api/developer/tools/{tool}
openapi: 3.1.0
info:
  title: ArcPay Somnia Developer API
  version: 0.1.2
  summary: >-
    Public developer surface for ArcPay's Somnia x402, workspace evidence, and
    agent integration flows.
  description: >-
    ArcPay Somnia exposes a wallet-first app, a live x402 payment server, an MCP
    server for local agent hosts, and OpenAPI-compatible endpoint docs for
    developers building on Somnia Testnet.
servers:
  - url: https://x402.20.208.46.195.nip.io
    description: Live ArcPay Somnia x402 server
  - url: https://arcpay-somnia.vercel.app
    description: ArcPay Somnia frontend and workspace API
security: []
tags:
  - name: x402
    description: HTTP 402 payment-gated agent work on Somnia.
  - name: Workspace
    description: Workspace authentication and evidence mirror endpoints.
  - name: Beta
    description: Public beta access requests for Somnia builders and operators.
  - name: Discovery
    description: Machine-readable docs and integration discovery.
  - name: Developer Tools
    description: HTTP wrapper around safe ArcPay MCP-style tools.
  - name: MCP
    description: Hosted MCP-style JSON-RPC bridge for agent clients.
  - name: Developer Keys
    description: Workspace-scoped bearer keys for hosted MCP access.
  - name: Admin
    description: Operator-only beta queue management endpoints.
  - name: Status
    description: Runtime health checks for ArcPay Somnia production surfaces.
paths:
  /api/developer/tools/{tool}:
    get:
      tags:
        - Developer Tools
      summary: Run a developer tool by URL
      description: >-
        Runs a tool with query-string arguments. Text tools return text/plain;
        JSON tools return application/json.
      operationId: runDeveloperToolByUrl
      parameters:
        - name: tool
          in: path
          required: true
          schema:
            type: string
            enum:
              - get_deployment
              - derive_agent_id
              - derive_invoice_id
              - derive_claim_hash
              - derive_privacy_commitment
              - privacy_intent_guide
              - invoice_guide
              - x402_guide
              - somnia_defi_adapters
              - starter_kit
              - roadmap
      responses:
        '200':
          description: Tool result.

````