npm @settlegrid/discoverystdioupdated 2mo ago
The Settlement Layer for AI Agent Payments
What can you do with settlegrid discovery?
Quick Start
npm install @settlegrid/mcp
import { settlegrid } from '@settlegrid/mcp'
const sg = settlegrid.init({
toolSlug: 'my-tool',
pricing: { defaultCostCents: 5 },
})
const billedHandler = sg.wrap(myHandler)
Every call validates the consumer's API key, checks their credit balance, executes your function, and meters usage โ all with a single Redis balance check on the hot path.
Or scaffold a complete project instantly:
npx create-settlegrid-tool
Why SettleGrid?
| SettleGrid | Stripe Billing | Nevermined | Paid.ai | |
|---|---|---|---|---|
| Protocol support | 14 tracked (9 brokered + 2 detection + 3 emerging) | REST only | x402 / DeFi | MCP only |
| Real-time metering | Redis hot path | Batch only | On-chain | Per-call |
| Built-in discovery | 8+ registries | None | None | None |
| Multi-hop settlement | Yes | No | Yes | No |
| Agent identity (KYA) | Yes | No | No | No |
| Budget enforcement | Yes | No | No | No |
| Outcome-based billing | Yes | No | Yes | No |
| Free tier (0% fees) | Yes | No | No | No |
| $1 minimum payout | Yes | No | No | No |
| Open-source SDK | Yes | No | Yes | No |
| Fraud detection | Yes | Yes | No | No |
Discovery โ Your Tools, Found Everywhere
SettleGrid doesn't just bill โ it distributes. Every active tool is automatically discoverable across:
| Channel | How it works |
|---|---|
| Showcase | Consumers browse, search, and purchase credits |
| Discovery API | GET /api/v1/discover โ programmatic search for directories & apps |
| MCP Discovery Server | AI agents find tools natively via MCP protocol |
| HTTP MCP Endpoint | Remote streamable HTTP transport for any MCP client |
| Official MCP Registry | The canonical MCP server registry |
| Smithery | 6,000+ MCP server directory |
| Glama | 14,000+ MCP server directory |
| RSS Feed | New tools syndicated automatically |
{
"mcpServers": {
"settlegrid-discovery": {
"command": "npx",
"args": ["@settlegrid/discovery"]
}
}
}
6 Pricing Models
| Model | Best for | Example |
|---|---|---|
| Per-Invocation | Search, lookups, CRUD | 5ยข/call |
| Per-Token | LLM wrappers, text processing | $0.001/1K tokens |
| Per-Byte | File conversion, data export | 1ยข/MB |
| Per-Second | Video processing, ML inference | 2ยข/second |
| Tiered | Multi-method tools | read 1ยข, write 5ยข |
| Outcome-Based | Lead gen, data extraction | 25ยข on success |
Payment Protocol Coverage
The @settlegrid/mcp SDK adds native billing to any Model Context Protocol (MCP) tool server and provides a REST middleware for any HTTP service. On top of that, the hosted Smart Proxy at settlegrid.ai/api/proxy/{slug} brokers payments across agent payment protocols and tracks emerging specs as they mature.
9 brokered by the Smart Proxy (production or pending GA): MCP ยท x402 (Coinbase) ยท Stripe MPP ยท AP2 (Google) ยท ACP (OpenAI) ยท UCP (Google/Shopify) ยท Visa TAP ยท Mastercard Verifiable Intent ยท Circle Nanopayments
2 detection-adapter-only: L402 (Bitcoin Lightning) ยท KYAPay (Skyfire)
3 tracked as emerging: ACTP (Alipay's Agentic Commerce Trust Protocol) ยท EMVCo agent payments ยท DRAIN (Bittensor Subnet 58)
Features
Billing & Metering
- A single Redis balance check on the hot path, on every call
- Budget enforcement โ HTTP 402 when exceeded
- Auto-refill credits via Stripe
- Multi-hop settlement across agent chains โ each hop settled as it completes
Security & Compliance
- Agent identity (KYA) with trust scoring
- Fraud detection (12 real-time signals)
- IP allowlisting (CIDR support)
- HMAC-SHA256 webhook signatures
- Audit logging with CSV export (SOC 2 ready)
- Sandbox/test mode
Developer Experience
sg.wrap()โ one function, any handler- 6 pricing models configurable from dashboard
- 97 open-source templates with billing pre-wired
- CLI scaffolder:
npx create-settlegrid-tool - Discovery tab with badge generator, checklist, API URLs
- Consumer reviews with developer responses
- Quality gates + Verified badge for activated tools
- Proactive monitoring (onboarding drip, quality alerts, monthly summary)
Pricing
| Tier | Price | Ops/month | Take Rate |
|---|---|---|---|
| Free | $0 forever | 25,000 | 0% |
| Starter | $9/mo | 100,000 | 5% |
| Growth | $29/mo | 500,000 | 5% |
| Scale | $79/mo | 2,000,000 | 5% |
$1 minimum payout โ the lowest in the industry. Stripe Connect Express for instant payouts.
REST API Middleware
For non-MCP services (Express, Next.js, Hono, etc.):
import { settlegridMiddleware } from '@settlegrid/mcp'
const withBilling = settlegridMiddleware({
toolSlug: 'my-api',
costCents: 5,
})
export async function GET(request: Request) {
return withBilling(request, async () => {
return Response.json({ data: 'hello' })
})
}
Project Structure
settlegrid/
โโโ apps/web/ # Next.js 15 platform (settlegrid.ai)
โโโ packages/mcp/ # @settlegrid/mcp SDK
โโโ packages/discovery-server/ # @settlegrid/discovery MCP server
โโโ packages/create-tool/ # npx create-settlegrid-tool CLI
โโโ open-source-servers/ # 1,017 indexed MCP servers
โโโ .mcp.json # MCP plugin config (Cursor, Claude)
Links
| Website | settlegrid.ai |
| Documentation | settlegrid.ai/docs |
| Discovery Guide | settlegrid.ai/learn/discovery |
| Handbook | settlegrid.ai/learn/handbook |
| API Reference | settlegrid.ai/api/openapi.json |
| Discovery API | settlegrid.ai/api/v1/discover |
| RSS Feed | settlegrid.ai/api/feed |
| npm (SDK) | @settlegrid/mcp |
| npm (Discovery) | @settlegrid/discovery |
| MCP Registry | io.github.lexwhiting/settlegrid-discovery |
| Support | support@settlegrid.ai |
License
MIT ยฉ 2026 SettleGrid
Install
Add settlegrid discovery to your client. Pick the one you use.
claude mcp add discovery -- npx -y @settlegrid/discoverycodex mcp add discovery -- npx -y @settlegrid/discoveryamp mcp add discovery -- npx -y @settlegrid/discovery{
"mcpServers": {
"discovery": {
"command": "npx",
"args": [
"-y",
"@settlegrid/discovery"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"discovery": {
"command": "npx",
"args": [
"-y",
"@settlegrid/discovery"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"discovery","command":"npx","args":["-y","@settlegrid/discovery"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"discovery": {
"command": "npx",
"args": [
"-y",
"@settlegrid/discovery"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"discovery": {
"command": "npx",
"args": [
"-y",
"@settlegrid/discovery"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"discovery": {
"command": "npx",
"args": [
"-y",
"@settlegrid/discovery"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"discovery": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@settlegrid/discovery"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"discovery": {
"command": {
"path": "npx",
"args": [
"-y",
"@settlegrid/discovery"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @settlegrid/discoveryRun `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation25/25
- Maintenance16/25
- Trust6/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 57 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 1.0.1Latest | Mar 24, 2026 |