Skip to main content
Glama

Submit a listing to PayAPI Market

submit_listing

List one or more APIs. The minimum is a paid URL (url, paid_route_url, or urls) and contact_email (email is accepted as the same field). Price, payTo, network, description and name are read from the HTTP 402 when you omit them. Category defaults to Data, which the listing schema accepts. urls takes at most 20 routes. Each route is probed and returned in results as listed, pending or rejected, with a code and a hint when it is turned away. A no-input GET that returns a valid 402 may omit sample_input. Placeholder examples are rejected. NEVER sets payment_verified or makes the listing live. PayAPI Market may test it with a real paid call (up to $0.10 USDC on Base). Listing is free. PayAPI takes 0% of each job. Rate limited: max 10 submissions per hour per wallet and per contact email, 50 per day per IP and per payTo address. The cap still applies inside a urls array. If this wallet already submitted this API, the result is the existing listing id and the message "This API has already been submitted." No second row is created. The same wallet and email can update a listing that is still pending review.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "contact_email": "<contact_email>"
    },
    "name": "submit_listing"
  }
}

Input Schema

NameRequiredDescriptionDefault
urlNoOne https route that returns HTTP 402. Use this, paid_route_url, or urls.
nameNoAPI name. Read from the 402 when omitted.
urlsNoUp to 20 paid routes in one call. Each is probed on its own.
emailNoSame as contact_email.
payToNoBase wallet that receives USDC. Read from the 402 when omitted.
priceNoPrice per request in USDC. Read from the Base accept when omitted.
methodNoHow we call the paid route. Read from the 402 when omitted. GET uses sample_input as a query string. POST uses it as a JSON body.
networkNoOnly listings that accept USDC on this network: base, solana, algorand, avalanche, or a CAIP-2 id. Omit for all. Each listing reports its rails in `networks`.
base_urlNoBase URL of the API (https only, no localhost or tunnels). Defaults to the paid route origin.
categoryNoAPI category. Defaults to Data when omitted. There is no Other category.
networksNoNetworks this API accepts (e.g. ["base"], ["base", "solana"]). The Base rail is read from the 402.
sample_urlNoOptional free sample or health URL. Called unpaid, before any paid check.
descriptionNoAPI description. Read from the 402 or /.well-known/x402 when omitted.
mcp_endpointNoOptional: MCP endpoint URL if this is an MCP server
sample_inputNoExample request. A query string for GET (city=London) or a JSON body for POST ({"city":"London"}). Read from the 402 when omitted. A no-input GET with a valid 402 may leave this empty. Placeholders are rejected.
contact_emailYesContact email for the provider. Required. email is the same field.
provider_nameNoOptional: provider/company name (defaults to API name)
paid_route_urlNoThe exact route that requires x402 payment. Same as url.
input_param_to_varyNoOptional parameter name to change between two free sample calls, for example city.
settles_after_successNoConfirm the paid route settles only after a successful response. Required only when the server switch is on.
example_expected_outputNoOptional JSON shape or short sample the free check compares against.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / network / description
      Previous value: -"Only listings that accept USDC on this network: base, solana, algorand, or a CAIP-2 id. Omit for all. Each listing reports its rails in `networks`."New value: +"Only listings that accept USDC on this network: base, solana, algorand, avalanche, or a CAIP-2 id. Omit for all. Each listing reports its rails in `networks`."
  2. Changed19 schema fields changed
    • changedInput schema / properties / base_url / description
      Previous value: -"Base URL of the API (http(s) only, no localhost/tunnels)"New value: +"Base URL of the API (https only, no localhost or tunnels). Defaults to the paid route origin."
    • changedInput schema / properties / category / description
      Previous value: -"API category"New value: +"API category. Defaults to Data when omitted. There is no Other category."
    • changedInput schema / properties / contact_email / description
      Previous value: -"Contact email for the provider"New value: +"Contact email for the provider. Required. email is the same field."
    • changedInput schema / properties / description / description
      Previous value: -"API description"New value: +"API description. Read from the 402 or /.well-known/x402 when omitted."
    • addedInput schema / properties / email
      Added value: +{
      +  "description": "Same as contact_email.",
      +  "type": "string"
      +}
    • addedInput schema / properties / example_expected_output
      Added value: +{
      +  "description": "Optional JSON shape or short sample the free check compares against.",
      +  "type": "string"
      +}
    • addedInput schema / properties / input_param_to_vary
      Added value: +{
      +  "description": "Optional parameter name to change between two free sample calls, for example city.",
      +  "type": "string"
      +}
    • addedInput schema / properties / method
      Added value: +{
      +  "description": "How we call the paid route. Read from the 402 when omitted. GET uses sample_input as a query string. POST uses it as a JSON body.",
      +  "enum": [
      +    "GET",
      +    "POST"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / name / description
      Previous value: -"API name"New value: +"API name. Read from the 402 when omitted."
    • changedInput schema / properties / networks / description
      Previous value: -"Networks this API accepts (e.g. [\"base\"], [\"base\", \"solana\"])"New value: +"Networks this API accepts (e.g. [\"base\"], [\"base\", \"solana\"]). The Base rail is read from the 402."
    • changedInput schema / properties / paid_route_url / description
      Previous value: -"The exact route that requires x402 payment (http(s) only)"New value: +"The exact route that requires x402 payment. Same as url."
    • changedInput schema / properties / payTo / description
      Previous value: -"Wallet address that receives payments (Base: 0x... address, Solana: base58 address)"New value: +"Base wallet that receives USDC. Read from the 402 when omitted."
    • changedInput schema / properties / price / description
      Previous value: -"Price per request in USDC"New value: +"Price per request in USDC. Read from the Base accept when omitted."
    • changedInput schema / properties / sample_input / description
      Previous value: -"Optional: sample request body for POST routes"New value: +"Example request. A query string for GET (city=London) or a JSON body for POST ({\"city\":\"London\"}). Read from the 402 when omitted. A no-input GET with a valid 402 may leave this empty. Placeholders are rejected."
    • addedInput schema / properties / sample_url
      Added value: +{
      +  "description": "Optional free sample or health URL. Called unpaid, before any paid check.",
      +  "type": "string"
      +}
    • addedInput schema / properties / settles_after_success
      Added value: +{
      +  "description": "Confirm the paid route settles only after a successful response. Required only when the server switch is on.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / url
      Added value: +{
      +  "description": "One https route that returns HTTP 402. Use this, paid_route_url, or urls.",
      +  "type": "string"
      +}
    • addedInput schema / properties / urls
      Added value: +{
      +  "description": "Up to 20 paid routes in one call. Each is probed on its own.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "name",
      -  "description",
      -  "paid_route_url",
      -  "price",
      -  "payTo",
      -  "contact_email",
      -  "category"
      -]New value: +[
      +  "contact_email"
      +]
  3. Changed19 schema fields changed
    • changedInput schema / properties / base_url / description
      Previous value: -"Base URL of the API (https only, no localhost or tunnels). Defaults to the paid route origin."New value: +"Base URL of the API (http(s) only, no localhost/tunnels)"
    • changedInput schema / properties / category / description
      Previous value: -"API category. Defaults to Data when omitted. There is no Other category."New value: +"API category"
    • changedInput schema / properties / contact_email / description
      Previous value: -"Contact email for the provider. Required. email is the same field."New value: +"Contact email for the provider"
    • changedInput schema / properties / description / description
      Previous value: -"API description. Read from the 402 or /.well-known/x402 when omitted."New value: +"API description"
    • removedInput schema / properties / email
      Removed value: -{
      -  "description": "Same as contact_email.",
      -  "type": "string"
      -}
    • removedInput schema / properties / example_expected_output
      Removed value: -{
      -  "description": "Optional JSON shape or short sample the free check compares against.",
      -  "type": "string"
      -}
    • removedInput schema / properties / input_param_to_vary
      Removed value: -{
      -  "description": "Optional parameter name to change between two free sample calls, for example city.",
      -  "type": "string"
      -}
    • removedInput schema / properties / method
      Removed value: -{
      -  "description": "How we call the paid route. Read from the 402 when omitted. GET uses sample_input as a query string. POST uses it as a JSON body.",
      -  "enum": [
      -    "GET",
      -    "POST"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / name / description
      Previous value: -"API name. Read from the 402 when omitted."New value: +"API name"
    • changedInput schema / properties / networks / description
      Previous value: -"Networks this API accepts (e.g. [\"base\"], [\"base\", \"solana\"]). The Base rail is read from the 402."New value: +"Networks this API accepts (e.g. [\"base\"], [\"base\", \"solana\"])"
    • changedInput schema / properties / paid_route_url / description
      Previous value: -"The exact route that requires x402 payment. Same as url."New value: +"The exact route that requires x402 payment (http(s) only)"
    • changedInput schema / properties / payTo / description
      Previous value: -"Base wallet that receives USDC. Read from the 402 when omitted."New value: +"Wallet address that receives payments (Base: 0x... address, Solana: base58 address)"
    • changedInput schema / properties / price / description
      Previous value: -"Price per request in USDC. Read from the Base accept when omitted."New value: +"Price per request in USDC"
    • changedInput schema / properties / sample_input / description
      Previous value: -"Example request. A query string for GET (city=London) or a JSON body for POST ({\"city\":\"London\"}). Read from the 402 when omitted. A no-input GET with a valid 402 may leave this empty. Placeholders are rejected."New value: +"Optional: sample request body for POST routes"
    • removedInput schema / properties / sample_url
      Removed value: -{
      -  "description": "Optional free sample or health URL. Called unpaid, before any paid check.",
      -  "type": "string"
      -}
    • removedInput schema / properties / settles_after_success
      Removed value: -{
      -  "description": "Confirm the paid route settles only after a successful response. Required only when the server switch is on.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / url
      Removed value: -{
      -  "description": "One https route that returns HTTP 402. Use this, paid_route_url, or urls.",
      -  "type": "string"
      -}
    • removedInput schema / properties / urls
      Removed value: -{
      -  "description": "Up to 20 paid routes in one call. Each is probed on its own.",
      -  "items": {
      -    "type": "string"
      -  },
      -  "maxItems": 20,
      -  "type": "array"
      -}
    • changedInput schema / required
      Previous value: -[
      -  "contact_email"
      -]New value: +[
      +  "name",
      +  "description",
      +  "paid_route_url",
      +  "price",
      +  "payTo",
      +  "contact_email",
      +  "category"
      +]
  4. Changed15 schema fields changed
    • changedInput schema / properties / base_url / description
      Previous value: -"Base URL of the API (http(s) only, no localhost/tunnels)"New value: +"Base URL of the API (https only, no localhost or tunnels). Defaults to the paid route origin."
    • changedInput schema / properties / category / description
      Previous value: -"API category"New value: +"API category. Defaults to Data when omitted. There is no Other category."
    • changedInput schema / properties / contact_email / description
      Previous value: -"Contact email for the provider"New value: +"Contact email for the provider. Required. email is the same field."
    • changedInput schema / properties / description / description
      Previous value: -"API description"New value: +"API description. Read from the 402 or /.well-known/x402 when omitted."
    • addedInput schema / properties / email
      Added value: +{
      +  "description": "Same as contact_email.",
      +  "type": "string"
      +}
    • changedInput schema / properties / method / description
      Previous value: -"How we call the paid route. GET uses sample_input as a query string. POST uses it as a JSON body."New value: +"How we call the paid route. Read from the 402 when omitted. GET uses sample_input as a query string. POST uses it as a JSON body."
    • changedInput schema / properties / name / description
      Previous value: -"API name"New value: +"API name. Read from the 402 when omitted."
    • changedInput schema / properties / networks / description
      Previous value: -"Networks this API accepts (e.g. [\"base\"], [\"base\", \"solana\"])"New value: +"Networks this API accepts (e.g. [\"base\"], [\"base\", \"solana\"]). The Base rail is read from the 402."
    • changedInput schema / properties / paid_route_url / description
      Previous value: -"The exact route that requires x402 payment (http(s) only)"New value: +"The exact route that requires x402 payment. Same as url."
    • changedInput schema / properties / payTo / description
      Previous value: -"Wallet address that receives payments (Base: 0x... address, Solana: base58 address)"New value: +"Base wallet that receives USDC. Read from the 402 when omitted."
    • changedInput schema / properties / price / description
      Previous value: -"Price per request in USDC"New value: +"Price per request in USDC. Read from the Base accept when omitted."
    • changedInput schema / properties / sample_input / description
      Previous value: -"Required example request. A query string for GET (city=London) or a JSON body for POST ({\"city\":\"London\"}). Placeholders are rejected."New value: +"Example request. A query string for GET (city=London) or a JSON body for POST ({\"city\":\"London\"}). Read from the 402 when omitted. A no-input GET with a valid 402 may leave this empty. Placeholders are rejected."
    • addedInput schema / properties / url
      Added value: +{
      +  "description": "One https route that returns HTTP 402. Use this, paid_route_url, or urls.",
      +  "type": "string"
      +}
    • addedInput schema / properties / urls
      Added value: +{
      +  "description": "Up to 20 paid routes in one call. Each is probed on its own.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "name",
      -  "description",
      -  "paid_route_url",
      -  "price",
      -  "payTo",
      -  "contact_email",
      -  "category",
      -  "sample_input"
      -]New value: +[
      +  "contact_email"
      +]
  5. Changed7 schema fields changed
    • addedInput schema / properties / example_expected_output
      Added value: +{
      +  "description": "Optional JSON shape or short sample the free check compares against.",
      +  "type": "string"
      +}
    • addedInput schema / properties / input_param_to_vary
      Added value: +{
      +  "description": "Optional parameter name to change between two free sample calls, for example city.",
      +  "type": "string"
      +}
    • addedInput schema / properties / method
      Added value: +{
      +  "description": "How we call the paid route. GET uses sample_input as a query string. POST uses it as a JSON body.",
      +  "enum": [
      +    "GET",
      +    "POST"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / sample_input / description
      Previous value: -"Optional: sample request body for POST routes"New value: +"Required example request. A query string for GET (city=London) or a JSON body for POST ({\"city\":\"London\"}). Placeholders are rejected."
    • addedInput schema / properties / sample_url
      Added value: +{
      +  "description": "Optional free sample or health URL. Called unpaid, before any paid check.",
      +  "type": "string"
      +}
    • addedInput schema / properties / settles_after_success
      Added value: +{
      +  "description": "Confirm the paid route settles only after a successful response. Required only when the server switch is on.",
      +  "type": "boolean"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "name",
      -  "description",
      -  "paid_route_url",
      -  "price",
      -  "payTo",
      -  "contact_email",
      -  "category"
      -]New value: +[
      +  "name",
      +  "description",
      +  "paid_route_url",
      +  "price",
      +  "payTo",
      +  "contact_email",
      +  "category",
      +  "sample_input"
      +]
  6. Added

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations declare a write, non-idempotent, non-destructive, closed-world operation, and the description adds substantial context beyond that: it never sets payment_verified or makes the listing live, the market may issue a real paid call up to $0.10 USDC on Base, listing is free with 0% fees, and there are concrete rate limits (10/hour per wallet and email, 50/day per IP and payTo). It also explains the duplicate-submission outcome, which is the main behavioral surprise for a non-idempotent write. Return statuses (listed/pending/rejected plus code and hint) are described, which is meaningful given there is no output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The most decision-critical facts (minimum inputs, defaults, no-live-effect) are front-loaded, and short declarative sentences about fees and caps are efficient. It is dense and runs long for a single tool, but nearly every sentence carries operational information rather than filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 21-parameter write with no output schema, the description covers the required minimum, the derivation of omitted fields, probe results and their status values, dedup behavior, rate limits, and the paid-call side effect. An agent has enough to call it correctly and to anticipate the response without an output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents every parameter, and much of the description's parameter talk (url/paid_route_url/urls, 402-derived fields, category defaulting to Data) restates it. What does add value is the explicit statement of the minimum valid combination and that 'url', 'paid_route_url', and 'urls' are interchangeable, which the schema's single required field does not make obvious.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening 'List one or more APIs' plus the title establishes that this submits/registers APIs rather than reading them, and the minimum-input sentence pins down the resource. It never explicitly distinguishes itself from read-only siblings like list_apis or search_apis, so an agent must infer the difference from context rather than being told.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It clearly states the minimum required inputs, the fallback behavior when optional fields are omitted, and the dedup path ('If this wallet already submitted this API, the result is the existing listing id'). It also carves out the update case for pending listings. It does not name any alternative tool or state when not to use this one, which keeps it below a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources