jarvisclaw-ai Intent API

The Intent API from jarvisclaw-ai — 6 operation(s) for intent.

Operations 6

POST /v1/intent/discover Discover Providers #
POST /v1/intent/execute Intent Execute #
POST /v1/intent/execute-budget Execute Intent with Budget #
POST /v1/intent/resolve Resolve Intent #
POST /v1/intent/resolve/natural Resolve Natural-Language Intent #
POST /v1/intent/subscribe Subscribe to Intent Fulfillment #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/jarvisclaw-ai:jarvisclaw-ai-intent-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jarvisclaw-ai-intent-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  contact:
    email: mkt@jarvisclaw.ai
    name: JarvisClaw
    url: https://jarvisclaw.ai
  description: AI API Gateway with smart routing, pay per call via x402. OpenAI-compatible. Settled in USDC on Base & Solana.
  title: JarvisClaw Intent API
  version: 1.0.0
  x-guidance: JarvisClaw is an OpenAI-compatible API gateway. Supports 80+ models including GPT-5, Claude, Gemini, DeepSeek. All endpoints accept x402 USDC payments — no API key needed for x402 callers. Beyond the model endpoints, thousands of individually priced third-party APIs (social and media, web search, code, documents, OCR, market and chain data, weather, DNS) are callable at POST /v1/marketplace/api/{resource_id}. This document lists the most commonly used of them; GET /api/marketplace/apis is free and returns the complete set with each resource_id and its exact price.
servers:
- description: Production
  url: https://api.jarvisclaw.ai
security:
- x402: []
tags:
- name: Intent
paths:
  /v1/intent/discover:
    post:
      description: Discover available providers and capabilities across the federation for a given capability class. Returns the live catalog an agent can act on.
      operationId: intentDiscover
      requestBody:
        content:
          application/json:
            schema:
              properties:
                capability:
                  description: Capability class to discover (e.g. 'text-generation', 'image', 'search')
                  type: string
              required:
              - capability
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                type: object
          description: Successful response
        '402':
          description: Payment Required
      security:
      - x402: []
      summary: Discover Providers
      x-bazaar:
        schema:
          properties:
            input:
              properties:
                body:
                  properties:
                    capability:
                      description: Capability class to discover
                      type: string
                  type: object
              type: object
            output:
              properties:
                example:
                  description: JSON response with requested data
                  type: object
              type: object
      x-payment-info:
        price:
          currency: USD
          max: '0.50'
          min: '0.0001'
          mode: dynamic
        protocols:
        - x402: {}
      tags:
      - Intent
  /v1/intent/execute:
    post:
      description: Resolve intent and execute against the best provider in one call. End-to-end agent task completion.
      operationId: intentExecute
      requestBody:
        content:
          application/json:
            schema:
              properties:
                budget:
                  description: Maximum budget in USD
                  type: number
                intent:
                  description: Natural language intent to resolve and execute
                  type: string
                provider:
                  description: 'Optional: specific provider ID to execute against'
                  type: string
              required:
              - intent
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                type: object
          description: Successful response
        '402':
          description: Payment Required
      security:
      - x402: []
      summary: Intent Execute
      x-bazaar:
        schema:
          properties:
            input:
              properties:
                body:
                  properties:
                    budget:
                      description: Maximum budget in USD
                      type: number
                    intent:
                      description: Natural language intent to resolve and execute
                      type: string
                    provider:
                      description: 'Optional: specific provider ID to execute against'
                      type: string
                  type: object
              type: object
            output:
              properties:
                example:
                  description: JSON response with requested data
                  type: object
              type: object
      x-payment-info:
        price:
          currency: USD
          max: '0.50'
          min: '0.0001'
          mode: dynamic
        protocols:
        - x402: {}
      tags:
      - Intent
  /v1/intent/execute-budget:
    post:
      description: 'Resolve and execute an intent under a hard budget ceiling. The router picks the best provider that fits the budget and completes the task end-to-end. Guarantees spend never exceeds the cap. Requires an API key: the budget is enforced against the key owner''s account, so x402 per-call payment is not accepted here.'
      operationId: intentExecuteBudget
      requestBody:
        content:
          application/json:
            schema:
              properties:
                budget:
                  description: Hard maximum budget in USD (enforced)
                  type: number
                intent:
                  description: Natural language intent to resolve and execute
                  type: string
              required:
              - intent
              - budget
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                type: object
          description: Successful response
        '401':
          description: Missing or invalid API key
      security:
      - apiKey: []
      summary: Execute Intent with Budget
      x-bazaar:
        schema:
          properties:
            input:
              properties:
                body:
                  properties:
                    budget:
                      description: Hard maximum budget in USD (enforced)
                      type: number
                    intent:
                      description: Natural language intent to resolve and execute
                      type: string
                  type: object
              type: object
            output:
              properties:
                example:
                  description: JSON response with requested data
                  type: object
              type: object
      tags:
      - Intent
  /v1/intent/resolve:
    post:
      description: Resolve a structured intent to the best-matching provider and route. Returns ranked candidates with confidence scores and pricing. The intent layer lets agents delegate 'what to call' instead of hard-coding endpoints.
      operationId: intentResolve
      requestBody:
        content:
          application/json:
            schema:
              properties:
                intent:
                  description: Structured intent object (capability, constraints, budget)
                  type: object
                top_k:
                  description: 'Number of ranked candidates to return (default: 3)'
                  type: integer
              required:
              - intent
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                type: object
          description: Successful response
        '402':
          description: Payment Required
      security:
      - x402: []
      summary: Resolve Intent
      x-bazaar:
        schema:
          properties:
            input:
              properties:
                body:
                  properties:
                    intent:
                      description: Structured intent object (capability, constraints, budget)
                      type: object
                    top_k:
                      description: 'Number of ranked candidates to return (default: 3)'
                      type: integer
                  type: object
              type: object
            output:
              properties:
                example:
                  description: JSON response with requested data
                  type: object
              type: object
      x-payment-info:
        price:
          currency: USD
          max: '0.50'
          min: '0.0001'
          mode: dynamic
        protocols:
        - x402: {}
      tags:
      - Intent
  /v1/intent/resolve/natural:
    post:
      description: Resolve a free-text natural-language intent (e.g. 'find the cheapest image generation under 2 cents') into ranked provider candidates. Ideal for LLM agents that emit plain language.
      operationId: intentResolveNatural
      requestBody:
        content:
          application/json:
            schema:
              properties:
                query:
                  description: Natural-language description of the desired capability
                  type: string
                top_k:
                  description: 'Number of ranked candidates to return (default: 3)'
                  type: integer
              required:
              - query
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                type: object
          description: Successful response
        '402':
          description: Payment Required
      security:
      - x402: []
      summary: Resolve Natural-Language Intent
      x-bazaar:
        schema:
          properties:
            input:
              properties:
                body:
                  properties:
                    query:
                      description: Natural-language description of the desired capability
                      type: string
                    top_k:
                      description: 'Number of ranked candidates to return (default: 3)'
                      type: integer
                  type: object
              type: object
            output:
              properties:
                example:
                  description: JSON response with requested data
                  type: object
              type: object
      x-payment-info:
        price:
          currency: USD
          max: '0.50'
          min: '0.0001'
          mode: dynamic
        protocols:
        - x402: {}
      tags:
      - Intent
  /v1/intent/subscribe:
    post:
      description: Create a standing subscription that re-resolves and fulfills an intent on a schedule or trigger. Lets agents set up recurring tasks (e.g. a daily market summary) with a single call.
      operationId: intentSubscribe
      requestBody:
        content:
          application/json:
            schema:
              properties:
                intent:
                  description: Natural language intent to fulfill on a recurring basis
                  type: string
                schedule:
                  description: Cron expression or trigger describing when to re-fulfill
                  type: string
              required:
              - intent
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                type: object
          description: Successful response
        '402':
          description: Payment Required
      security:
      - x402: []
      summary: Subscribe to Intent Fulfillment
      x-bazaar:
        schema:
          properties:
            input:
              properties:
                body:
                  properties:
                    intent:
                      description: Natural language intent to fulfill on a recurring basis
                      type: string
                    schedule:
                      description: Cron expression or trigger describing when to re-fulfill
                      type: string
                  type: object
              type: object
            output:
              properties:
                example:
                  description: JSON response with requested data
                  type: object
              type: object
      x-payment-info:
        price:
          currency: USD
          max: '0.50'
          min: '0.0001'
          mode: dynamic
        protocols:
        - x402: {}
      tags:
      - Intent
components:
  securitySchemes:
    apiKey:
      description: 'JarvisClaw API key: Authorization: Bearer sk-...'
      scheme: bearer
      type: http
    x402:
      description: x402 USDC payment via PAYMENT-SIGNATURE header
      scheme: X402
      type: http
x-payment-defaults:
  asset: USDC
  facilitator: https://api.cdp.coinbase.com/platform/v2/x402
  network: eip155:8453
  payTo: '0xDC59fa7b64988B846e76eC9849bb68f889071506'