@httpayer/mcp
MCP (Model Context Protocol) server for HTTPayer. Lets AI agents call x402-enabled APIs using credit balance — no wallets, no blockchain, no Web3 knowledge required.
- Dashboard & API keys: app.httpayer.com
- npm: @httpayer/mcp
- GitHub:
エージェントを強化
公開元自身のコマンドです。PlugMCP のエンドポイントではありません。
キーとログ付きでコピーをホスト。
npx -y @httpayer/[email protected]Claude Code にはローカルコマンド用のインストールリンクがありません。下のコマンドをコピーして、ターミナルで実行してください。
claude mcp add io.github.httpayer-mcp -- npx -y @httpayer/mcp@0.1.7ターミナルで実行します。
{ "mcpServers": { "io.github.httpayer-mcp": { "command": "npx", "args": [ "-y", "@httpayer/[email protected]" ] } }}claude_desktop_config.json
リモート URL か、手元のマシンのコマンドか 2 つのインストール方法の違い
PlugMCP で実行
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
起動公開元より
MCP (Model Context Protocol) server for HTTPayer. Lets AI agents call x402-enabled APIs using credit balance — no wallets, no blockchain, no Web3 knowledge required.
x402 micropayments for AI agents — credits-based, no wallets, no blockchain.
Paste this into any MCP-compatible agent (Claude Code, Cursor, Windsurf, OpenCode...):
Set up https://httpayer.com/skill.md
The agent detects your environment and handles everything automatically.
1. Run setup:
npx @httpayer/mcp setup
Get your API key at app.httpayer.com when prompted.
Flags:
2. Add to your client:
Claude Code:
claude mcp add httpayer --scope user -- npx -y @httpayer/mcp@latest
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"httpayer": {
"command": "npx",
"args": ["-y", "@httpayer/mcp@latest"]
}
}
}
Cursor (.cursor/mcp.json), Windsurf (.windsurf/mcp.json), Cline (.cline/mcp_settings.json):
{
"mcpServers": {
"httpayer": {
"command": "npx",
"args": ["-y", "@httpayer/mcp@latest"]
}
}
}
OpenCode (opencode.json or ~/.config/opencode/config.json):
{
"mcp": {
"httpayer": {
"type": "local",
"command": ["npx", "-y", "@httpayer/mcp@latest"],
"enabled": true
}
}
}
Zed:
{
"context_servers": {
"httpayer": {
"command": {
"path": "npx",
"args": ["-y", "@httpayer/mcp@latest"]
}
}
}
}
3. Restart your client and verify:
Ask your agent: "fetch https://api.httpayer.com/demo/v1/base-weather"
A weather response means HTTPayer is working.
User prompt
│
▼
AI agent (Claude Code, Cursor, Windsurf...)
│ uses MCP tools + prompts + resources
▼
@httpayer/mcp (local MCP server via npx)
│ REST calls with x-api-key header
▼
api.httpayer.com
│ proxy handles x402 payment to target
▼
Target x402-gated API
npx -y @httpayer/mcp@latest on startup (stdio transport).~/.httpayer/mcp-config.json.fetch, the MCP server forwards the request to POST https://api.httpayer.com/proxy.This server exposes three MCP primitives so agents get context automatically — without the user having to ask.
Six tools (see full reference below).
Compatible clients (Claude Desktop, Cursor, and others) call prompts/list on connection and inject these into the agent's context proactively.
get_balanceCheck credit balance and daily usage.
Input: none
Example response:
{
"account_id": "account_123",
"mainnet": {
"credits_balance": 50000,
"daily_limit": 100000,
"daily_spend": 15500,
"daily_remaining": 84500
}
}
fetchMake an HTTP request to any x402-enabled endpoint. Payment is handled automatically.
Input:
Example response:
{
"status": 200,
"body": { "data": "..." },
"headers": { "content-type": "application/json" }
}
On 502, the response includes webhook_id for async polling.
simulateDry-run a fetch. Returns cost estimate without spending credits.
Input: Same as fetch (except timeout).
Example response:
{
"requiresPayment": true,
"proxyFeeBreakdown": {
"targetAmount": 0.01,
"proxyFee": 0.0003,
"totalCreditsCharged": 10.3
}
}
get_topup_linkReturns the dashboard URL to add credits. Show to user when balance is low.
Input: none
check_limitsCheck global HTTPayer system daily limits and remaining capacity.
Input: none
get_webhook_statusPoll the status of an async operation. Use when fetch returns a 502 with webhook_id.
Input: webhook_id (string, required)
Status values: pending, success, success_refunded, payment_failed, upstream_error, internal_error, rate_limited
Authentication: x-api-key: sk-live-... header on all requests.
POST https://api.httpayer.com/proxy
{
"api_url": "https://target.example.com/endpoint",
"method": "GET",
"json": { "key": "value" },
"params": { "query": "param" },
"headers": { "Custom-Header": "value" },
"timeout": 30
}
Only api_url and method are required.
Status codes:
API key stored at: ~/.httpayer/mcp-config.json
{ "apiKey": "sk-live-..." }
To update: npx @httpayer/mcp setup --update-key
x402 is an HTTP-native micropayment protocol using the 402 Payment Required status code.
Without HTTPayer:
402 + payment requirementsWith HTTPayer:
POST /proxy { api_url, method, ... }402, pays using your creditsAll blockchain interaction happens on HTTPayer's side.
Top up at app.httpayer.com. Below 100 credits, the agent will prompt you to top up.
All errors return isError: true — the server stays alive and the agent gets a readable message.
© 2026 HTTPayer Inc.
x402 micropayments for AI agents — credits-based, no wallets, no blockchain.
{ "mcpServers": { "io.github.httpayer-mcp": { "command": "npx", "args": [ "-y", "@httpayer/[email protected]" ] } }}ツール
ツール一覧はまだありません。リモートサーバーは、最初のヘルスチェック後に取得されます。
よくある質問
このページで Cursor、Claude Desktop、Claude Code、VS Code 用の stdio 設定をコピーできます。PlugMCP のプロキシではなく、公開元のインストール方法を使います。
このレコードに必須の環境変数は記載されていません。
HTTPayer は stdio 経由でローカル実行されます。
最終チェックは 2026-11-09 です。 x402 micropayments for AI agents — credits-based, no wallets, no blockchain.