{"uid":"cap_174C7Mb0eaAcgbU3efKr2","slug":"intent-to-endpoint-matchmaker-api-e6afad05","name":"Intent-to-Endpoint Matchmaker API","description":"Match normalized agent intents to endpoint contracts with explainable constraints.","url":"https://intent-api-matchmaker-mainnet-production.up.railway.app/v1/match","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"intents":{"type":"array","maxItems":100,"minItems":1,"description":"Normalized agent intents; raw prompts and identities are not accepted."},"endpoints":{"type":"array","maxItems":100,"minItems":1},"limitPerIntent":{"type":"integer","maximum":10,"minimum":1},"minimumFitScore":{"type":"number","maximum":1,"minimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xLUo4UwPhLz950zjAx_7f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Matches normalized agent intents to the most fitting endpoint contracts, returning ranked results with explainable fit scores and constraints.","exampleAgentPrompt":"I have a list of 5 normalized agent intents and 20 candidate endpoint contracts — can you match each intent to up to 3 endpoints, only returning results with a fit score above 0.7, and explain why each match fits?","exampleUseCases":[{"title":"Route agent task to best endpoint","prompt":"I have 10 normalized intents from my orchestration layer and a catalog of 50 endpoint contracts — match each intent to up to 5 endpoints with a minimum fit score of 0.6, so I know which APIs to actually call."},{"title":"Filter low-quality endpoint matches","prompt":"Given these 8 agent intents and 30 candidate endpoints, return only the matches where the fit score is at least 0.8, limiting to 2 results per intent — I only want high-confidence routing decisions."},{"title":"Build intent-aware API discovery tool","prompt":"I'm building an agent that needs to pick the right API for each task — can you take these 15 normalized intents and this list of 100 endpoint contracts, and return the top 1 match per intent with an explanation of why it fits?"}],"resultDescription":"A ranked list of endpoint matches per intent, each including a fit score (0–1), the matched endpoint contract details, and explainable constraints describing why the endpoint was selected or deprioritized. Results are filtered by minimumFitScore and capped at limitPerIntent matches per intent.","failureModes":["Intents array is empty or exceeds 100 items — validation error returned","Endpoints array is empty or exceeds 100 items — validation error returned","Raw prompts or user identities passed as intents instead of normalized form — rejected by schema","minimumFitScore outside 0–1 range — validation error","limitPerIntent outside 1–10 range — validation error","No endpoints meet the minimumFitScore threshold — empty matches array returned","Payment not provided or insufficient — x402 payment required response"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to dynamically route normalized intents to the best-fitting API contracts from a candidate set, especially when explainability of the match is important. Prefer it over static routing tables or manual API selection when the intent space is large or variable. Best suited for orchestration layers, agent frameworks, and API marketplaces that need scored, ranked, and explainable endpoint recommendations at runtime.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:35:57.239Z","isFirstParty":false}