* feat(bazaar): add MCP resource type support to Go SDK Add MCP tool discovery extensions to the bazaar package, achieving parity with the TypeScript and Python SDKs. Servers can now declare MCP tool discovery extensions alongside HTTP resources, and facilitators can detect and extract them from payment payloads. Co-Authored-By: Claude <noreply@anthropic.com> * fix: gofmt formatting and gocritic if-else-chain lint Co-Authored-By: Claude <noreply@anthropic.com> * fix(bazaar): transport enum, doc examples, inline helper, add negative tests - Fix transport schema enum to include both valid values (streamable-http, sse) instead of only the provided value, matching TypeScript SDK behavior - Fix doc.go examples to use bazaar.BAZAAR.Key() instead of bazaar.BAZAAR - Inline createMcpDiscoveryExtension into DeclareMcpDiscoveryExtension - Add negative validation tests for wrong type and empty toolName - Add edge case tests for whitespace-only toolName and invalid transport Co-Authored-By: Claude <noreply@anthropic.com> * feat(mcp): wire extensions into PaymentWrapper 402 response Add Extensions field to PaymentWrapperConfig and pass it through to the PaymentRequired struct in 402 responses. This brings the MCP payment wrapper to parity with the HTTP middleware's RouteConfig.Extensions support, enabling bazaar discovery extensions in MCP tool responses. - Add Extensions map to PaymentWrapperConfig (types.go) - Set extensions in paymentRequiredResult (server.go) - Add unit tests for extensions present/absent in 402 (server_test.go) - Declare bazaar MCP extension in E2E server (main.go) - Add bazaar extension integration test (mcp_evm_test.go) Co-Authored-By: Claude <noreply@anthropic.com> * feat(mcp): wire TS extensions into 402 responses + Go integration tests Add extensions support to the TS MCP PaymentWrapperConfig and pass it through to createPaymentRequiredResponse so bazaar discovery metadata appears in 402 responses. Wire the E2E server with declareDiscoveryExtension for the get_weather tool. Add Go mocked-transport integration tests (5 cases) covering the full client↔server payment flow to match TS mcp-payment-flow.test.ts coverage. Co-Authored-By: Claude <noreply@anthropic.com> * fix: prettier formatting in MCP test files Co-Authored-By: Claude <noreply@anthropic.com> * fix(bazaar): address PR review feedback from @CarsonRoscoe - Use strings.TrimSpace for toolName validation to reject whitespace-only names - Allow custom transport values through schema validation (only enum for known transports) - Fix whitespace toolName test to assert error instead of success - Remove conditional guard in TS bazaar extension test so assertions always run Co-Authored-By: Claude <noreply@anthropic.com> * fix(bazaar): allow custom transport values in TS to match Go behavior Widen transport type from "streamable-http" | "sse" to string, and only apply enum constraint in schema for known transport values. This matches the Go-side fix so custom transports pass validation in both languages. Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com>
x402/mcp
MCP (Model Context Protocol) integration for the x402 payment protocol. This package enables paid tool calls in MCP servers and automatic payment handling in MCP clients.
Installation
go get github.com/x402-foundation/x402/go/mcp
Quick Start
Server - Using Payment Wrapper
package main
import (
"context"
"github.com/x402-foundation/x402/go/mcp"
mcpsdk "github.com/modelcontextprotocol/go-sdk/mcp"
)
func main() {
// Create x402 resource server
resourceServer := x402.Newx402ResourceServer(...)
resourceServer.Register("eip155:84532", evmServerScheme)
// Build payment requirements
accepts, _ := resourceServer.BuildPaymentRequirementsFromConfig(ctx, config)
// Create payment wrapper
wrapper := mcp.NewPaymentWrapper(resourceServer, mcp.PaymentWrapperConfig{
Accepts: accepts,
Resource: &mcp.ResourceInfo{URL: "mcp://tool/get_weather", Description: "Get weather"},
})
// Register paid tool - wrap handler (SDK-style)
mcpServer.AddTool(&mcpsdk.Tool{Name: "get_weather", ...}, wrapper.Wrap(
func(ctx context.Context, req *mcpsdk.CallToolRequest) (*mcpsdk.CallToolResult, error) {
return &mcpsdk.CallToolResult{
Content: []mcpsdk.Content{&mcpsdk.TextContent{Text: "Result"}},
}, nil
},
))
}
Client - Wrap Session with x402
package main
import (
"context"
"fmt"
"log"
"github.com/x402-foundation/x402/go/mcp"
mcpsdk "github.com/modelcontextprotocol/go-sdk/mcp"
)
func main() {
// Connect to MCP server using the official SDK
mcpClient := mcpsdk.NewClient(&mcpsdk.Implementation{
Name: "my-agent", Version: "1.0.0",
}, nil)
session, err := mcpClient.Connect(ctx, transport, nil)
if err != nil {
log.Fatal(err)
}
defer session.Close()
// Wrap session with x402 payment handling (AutoPayment defaults to true)
x402Mcp := mcp.NewX402MCPClientFromConfig(session, []mcp.SchemeRegistration{
{Network: "eip155:84532", Client: evmClientScheme},
}, mcp.Options{})
// Call tools - payment handled automatically
ctx := context.Background()
result, err := x402Mcp.CallTool(ctx, "get_weather", map[string]interface{}{
"city": "NYC",
})
if err != nil {
log.Fatal(err)
}
fmt.Println(result)
}
API Reference
Client
NewX402MCPClient
Creates an x402 MCP client from an MCP session (MCPCaller) and payment client.
paymentClient := x402.Newx402Client()
paymentClient.Register("eip155:84532", evmClientScheme)
x402Mcp := mcp.NewX402MCPClient(session, paymentClient, mcp.Options{})
NewX402MCPClientFromConfig
Creates a fully configured x402 MCP client with scheme registrations.
Pass *mcp.ClientSession from the official MCP SDK.
x402Mcp := mcp.NewX402MCPClientFromConfig(session, []mcp.SchemeRegistration{
{Network: "eip155:84532", Client: evmClientScheme},
}, mcp.Options{}) // AutoPayment defaults to true
Server
NewPaymentWrapper + Wrap
For servers using the official modelcontextprotocol/go-sdk. The MCP SDK's AddTool expects
handlers with signature (ctx, *mcp.CallToolRequest) → (*mcp.CallToolResult, error).
Supports server hooks (OnBeforeExecution, OnAfterExecution, OnAfterSettlement):
wrapper := mcp.NewPaymentWrapper(resourceServer, mcp.PaymentWrapperConfig{
Accepts: accepts,
Resource: &mcp.ResourceInfo{URL: "mcp://tool/get_weather", Description: "Get weather"},
Hooks: &mcp.PaymentWrapperHooks{
OnBeforeExecution: &beforeExecHook,
OnAfterExecution: &afterExecHook,
OnAfterSettlement: &afterSettleHook,
},
})
wrappedHandler := wrapper.Wrap(func(ctx context.Context, req *mcp.CallToolRequest) (*mcp.CallToolResult, error) {
return &mcp.CallToolResult{Content: []mcp.Content{&mcp.TextContent{Text: "result"}}}, nil
})
mcpServer.AddTool(tool, wrappedHandler)
Utilities
Error Handling
// Create payment required error
err := mcp.CreatePaymentRequiredError("Payment required", &paymentRequired)
// Check if error is payment required
if mcp.IsPaymentRequiredError(err) {
paymentErr := err.(*mcp.PaymentRequiredError)
// Handle payment required
}
// Extract PaymentRequired from JSON-RPC error
pr, err := mcp.ExtractPaymentRequiredFromError(jsonRpcError)
Type Guards
// Check if value is an object
if mcp.IsObject(value) {
obj := value.(map[string]interface{})
// Use obj
}
Constants
MCP_PAYMENT_REQUIRED_CODE- JSON-RPC error code for payment required (402)MCP_PAYMENT_META_KEY- MCP _meta key for payment payload ("x402/payment")MCP_PAYMENT_RESPONSE_META_KEY- MCP _meta key for payment response ("x402/payment-response")
Types
Client Types
X402MCPClient- x402-enabled MCP clientOptions- Options for x402 MCP client behavior (AutoPayment defaults to true)SchemeRegistration- Payment scheme registration for factory functionsMCPToolCallResult- Result of a tool call with payment metadataPaymentRequiredContext- Context provided to payment required hooksPaymentRequiredHookResult- Result from payment required hook
Server Types
PaymentWrapperConfig- Configuration for payment wrapperServerHookContext- Context provided to server-side hooksAfterExecutionContext- Context for after execution hookSettlementContext- Context for settlement hooks
Hook Types
PaymentRequiredHook- Hook called when payment is requiredBeforePaymentHook- Hook called before payment creationAfterPaymentHook- Hook called after payment submissionBeforeExecutionHook- Hook called before tool executionAfterExecutionHook- Hook called after tool executionAfterSettlementHook- Hook called after settlement
Examples
See the examples directory for complete examples.
License
Copyright (c) Coinbase, Inc.