Built · control planeMCP TypeScript SDK 2.4 · Streamable HTTP (stateless) · mainnet 4663 · testnet 46630
MCP server
An official PALISEC MCP server for MCP-compatible agents and applications. It is a standard interface to the same authorization path as the REST API, not a separate security mechanism.
Connect
Endpoint: https://palisec.tech/api/mcp (Streamable HTTP, stateless). Authenticate with an agent API key that has the mcp scope (create one in Console → Integrations). Each tool also checks its own scope, so an MCP key can be read-only.
mcp.json
{
"mcpServers": {
"palisec": {
"type": "http",
"url": "https://palisec.tech/api/mcp",
"headers": { "Authorization": "Bearer ${PALISEC_API_KEY}" }
}
}
}From code, with the official MCP client:
mcp-client.ts
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://palisec.tech/api/mcp"), {
requestInit: { headers: { authorization: `Bearer ${process.env.PALISEC_API_KEY}` } },
}));
const result = await client.callTool({
name: "palisec_propose_transaction",
arguments: { request_id: crypto.randomUUID(), chain_id: 46630, to: TOKEN, value_wei: "0",
data: calldata, gas_limit: 90000, deadline: Math.floor(Date.now() / 1000) + 120 },
});
// result.structuredContent.decision is ALLOW, DENY or REQUIRES_HUMAN_SIGNATURETools
| Tool | Scope | What it does |
|---|---|---|
palisec_get_account | policy:read | The agent, protected account, chain, scopes, bound policy and emergency-stop state. |
palisec_get_policy | policy:read | The exact active policy version the agent is evaluated against. |
palisec_evaluate_transaction | operations:write | Dry run. Reserves and records nothing. |
palisec_propose_transaction | operations:write | Records a decision with its budget reservation. Retry-safe by request_id. |
palisec_get_transaction_status | operations:read | State of one of the agent's operations. |
palisec_get_approval_status | operations:read | Approved, rejected, withdrawn or expired. |
palisec_request_human_approval | operations:read | Where approvers act on a held operation. It cannot approve anything. |
palisec_withdraw_approval_request | operations:write | Withdraw the agent's own pending approval. |
palisec_explain_authorization | operations:read | The deciding check, reason code and what to do next. |
palisec_get_audit_events | audit:read | Audit events the agent caused. |
palisec_validate_policy | policy:read | Validate a document against schema 1.0. Saves nothing. |
palisec_simulate_policy | policy:read | Evaluate a draft against one transaction with live inputs. Saves nothing. |
Errors
Tool failures return isError: true with { error: { code, message, retryable } } using the same reason codes. A key without the mcp scope, or a revoked key, is refused at connection (HTTP 401/403). Input is validated against each tool's schema.
Limits
- Same rate limit as the REST API: 120 requests a minute per key.
- Request bodies up to 256 KB. No sessions are held between requests.
- If the MCP endpoint is unavailable, the REST API and SDKs keep working independently.