r402-mcp 0.15.0

MCP transport for the x402 payment protocol (official rmcp SDK).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

#![cfg_attr(docsrs, feature(doc_cfg))]
#![doc = include_str!("../README.md")]
#![cfg_attr(
    test,
    allow(
        clippy::indexing_slicing,
        clippy::panic,
        clippy::expect_used,
        reason = "tests use panic/expect for clearer failure messages"
    )
)]

//! MCP transport for x402 on the official [`rmcp`] SDK.
//!
//! # Official pins
//!
//! | Component | Source |
//! |-----------|--------|
//! | Behaviour | `specs/transports-v2/mcp.md` |
//! | Control flow | Go `go/mcp/{server,client,utils}.go` |
//! | MCP types | **`rmcp`** (`modelcontextprotocol/rust-sdk`) |
//!
//! # Feature flags
//!
//! | Feature | Surface |
//! |---------|---------|
//! | `server` | [`PaymentWrapper`] |
//! | `client` | [`X402McpClient`], [`call_paid_tool`] |
//! | `full` | both + telemetry |

pub mod constants;

#[cfg(feature = "telemetry")]
use tracing as _;

#[cfg(any(feature = "server", feature = "client"))]
#[cfg_attr(docsrs, doc(cfg(any(feature = "server", feature = "client"))))]
pub mod encode;

#[cfg(any(feature = "server", feature = "client"))]
#[cfg_attr(docsrs, doc(cfg(any(feature = "server", feature = "client"))))]
pub mod error;

#[cfg(feature = "server")]
#[cfg_attr(docsrs, doc(cfg(feature = "server")))]
pub mod server;

#[cfg(feature = "client")]
#[cfg_attr(docsrs, doc(cfg(feature = "client")))]
pub mod client;

#[cfg(feature = "client")]
pub use client::{
    AfterPaymentContext, ClientHooks, McpToolCaller, PaidToolCallResult, PaymentRequiredContext,
    PaymentRequiredHookResult, PaymentSigner, X402McpClient, X402McpClientOptions, call_paid_tool,
};
pub use constants::{
    MCP_PAYMENT_META_KEY, MCP_PAYMENT_REQUIRED_CODE, MCP_PAYMENT_RESPONSE_META_KEY,
    MCP_TOOL_URL_PREFIX,
};
#[cfg(any(feature = "server", feature = "client"))]
pub use encode::{
    McpPaymentPayload, attach_payment_to_params, attach_settle_response, create_tool_resource_url,
    extract_payment_from_params, extract_payment_required, extract_settle_response,
    is_payment_required_result, payment_required_tool_result, settlement_failed_tool_result,
};
#[cfg(any(feature = "server", feature = "client"))]
pub use error::{McpClientError, PaymentRequiredError};
// `serde` is a workspace dep used transitively via wire types; silence when
// no direct path reference exists under the selected feature set.
use serde as _;
#[cfg(feature = "server")]
pub use server::{
    AfterExecutionContext, PaymentWrapper, PaymentWrapperConfig, PaymentWrapperConfigError,
    PaymentWrapperHooks, ServerHookContext, SettlementContext,
};