mcp-sdk

TypeScript MCP SDK for Deside integrations.

This package implements the public Deside MCP contract as a reusable client:

• MCP session bootstrap
• OAuth 2.0 + PKCE with wallet proof
• tool calls
• refresh token handling

It is not a framework adapter. It is the protocol-facing base that adapters can consume.

v0 covers:

• MCP session bootstrap
• OAuth 2.0 + PKCE with wallet proof
• tool calls
• refresh token handling
• shared tool wrappers

Supported tool wrappers:

• send_dm
• read_dms
• mark_dm_read
• list_conversations
• get_user_info
• get_my_identity
• search_agents

Validated against production on 2026-03-27:

• connect
• getMyIdentity
• listConversations
• sendDm

The SDK authenticated with wallet proof and delivered a real DM through https://mcp.deside.io/mcp.

The SDK is framework-agnostic and expects a signer with this shape:

type DesideSigner = {
  getAddress(): string | Promise<string>;
  signMessage(message: string): Promise<string | { signature: string }>;
};

Notes:

• getAddress() must return the authenticated Solana wallet
• signMessage() must sign the exact plaintext challenge message
• the SDK normalizes signature encoding internally

import { DesideMcpSdk, type DesideSigner } from "@desideapp/mcp-sdk";

const signer: DesideSigner = {
  getAddress: () => walletAddress,
  signMessage: async (message) => signMessageSomehow(message),
};

const sdk = new DesideMcpSdk({
  oauthRedirectUri: "https://agent.deside.io/callback",
});

await sdk.connect(signer);

const identity = await sdk.getMyIdentity(signer);
const conversations = await sdk.listConversations(signer, {});

Important:

• input payloads intentionally match the MCP contract shape
• that means tool arguments use snake_case, for example to_wallet,

conv_id, before_seq

• the SDK stays close to the public MCP contract

This