session_create

Open a budget-capped agent session on AgentPay.

Category Financial
Risk class Critical
Parameters 00 required

What session_create does on AgentPay x402 — Economic-intelligence layer for AI Agents

AI agents use session_create to commit financial operations through AgentPay x402 — Economic-intelligence layer for AI Agents — usually the final step of a payment, billing, or trading workflow. A call moves real money.

Why session_create needs a policy

Creating a session on AgentPay directly initiates a financial arrangement where USDC is allocated/committed for pay-per-call tool usage on Stellar. Even though it is 'budget-capped', it represents a financial obligation and enables subsequent monetary transactions, placing it in the Financial category.

From the tool's definition 'Open a budget-capped agent session on AgentPay' — establishes a financial session committing USDC funds on Stellar; 'Agents pay USDC on Stellar' and 'Budget-aware sessions' confirm financial commitment

Questions about session_create

What does the session_create tool do? +

Open a budget-capped agent session on AgentPay. It is categorised as a Financial tool in the AgentPay x402 — Economic-intelligence layer for AI Agents MCP Server, which means it involves financial transactions. Block by default and require explicit approval.

How do I enforce a policy on session_create? +

Register the AgentPay x402 — Economic-intelligence layer for AI Agents MCP server in PolicyLayer and add a rule for session_create: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches AgentPay x402 — Economic-intelligence layer for AI Agents. Nothing to install.

What risk level is session_create? +

session_create is a Financial tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit session_create? +

Yes. Add a rate_limit block to the session_create rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block session_create completely? +

Set action: deny in the PolicyLayer policy for session_create. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides session_create? +

session_create is provided by the AgentPay x402 — Economic-intelligence layer for AI Agents MCP server (romudille-bit/agentpay). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.