Deside Messaging Skill

Use this skill when you need wallet-native messaging on Solana through Deside.

This skill teaches the public Deside MCP flow. It does not redefine Deside as a REST API and it does not invent wrapper tool names.

Canonical MCP endpoint:

• - INLINECODE0

OAuth metadata:

• - INLINECODE1
• INLINECODE2

If you need bundle notes or the publication rule, see the local README.md next to this file.

What Deside Is

Deside exposes wallet-to-wallet messaging over MCP for Solana wallets.

Core capabilities for this skill:

1. 1. send DMs to a Solana wallet
2. read conversation history
3. list your DM conversations
4. inspect public identity for any wallet
5. inspect how Deside recognizes your own wallet
6. search the visible agent directory

Keep these buckets separate:

1. 1. messaging
2. identity
3. directory / discovery

They are related, but they are not the same thing.

When To Use This Skill

Use this skill when the task is any of these:

1. 1. send a message to a Solana wallet through Deside
2. read or inspect an existing DM conversation
3. check whether a wallet has a visible public profile in Deside
4. inspect how Deside recognizes the current wallet
5. find visible agents by name, category, or wallet

When Not To Use This Skill

Do not use this skill for:

1. 1. groups
2. INLINECODE4
3. INLINECODE5
4. claiming realtime notifications are guaranteed to arrive in every runtime situation
5. translating Deside MCP into a separate REST contract

Teach realtime DM notifications when the MCP session stays open, but keep inbox/history flows compatible with polling fallback.

Connection And Authentication

Deside MCP uses both:

1. 1. an MCP session created by INLINECODE6
2. an OAuth bearer token obtained through OAuth 2.0 + PKCE

In normal authenticated use, MCP requests need both:

1. 1. INLINECODE7
2. INLINECODE8

Recommended sequence:

1. 1. call MCP initialize against INLINECODE10
2. store the returned INLINECODE11
3. send INLINECODE12
4. run OAuth 2.0 + PKCE:

1. 5. make the first authenticated MCP tool call with both the bearer token and INLINECODE18
2. after that wallet-to-session bind, the same MCP session can receive INLINECODE19

The wallet signature is part of the OAuth flow. Do not describe auth as only “wallet signing”.

Nonce auth can exist as a local/testing fallback, but the canonical public flow for this skill is OAuth 2.0 + PKCE.

Use scopes intentionally:

1. 1. dm:read for read, identity, and directory tools
2. INLINECODE21 for INLINECODE22

Canonical Tools For This Skill

This skill teaches these MCP tools:

1. 1. INLINECODE23
2. INLINECODE24
3. INLINECODE25
4. INLINECODE26
5. INLINECODE27
6. INLINECODE28
7. INLINECODE29

Important:

• - mark_dm_read is part of the public MCP surface and is taught here as the canonical read-ack mutation
• teaching mark_dm_read does not imply that every downstream read-receipt UX is fully validated end-to-end outside this MCP contract

Realtime Delivery Model

Use this model when explaining how Deside messaging works:

1. 1. send outgoing messages with INLINECODE32
2. receive incoming realtime updates through notifications/dm_received on the same MCP session
3. use list_conversations and read_dms as the compatible fallback or resync path

Do not describe Deside as a separate socket API. The public contract is MCP tools plus MCP notifications.

Tool Selection Rules

Use these rules exactly:

1. 1. use get_my_identity for the authenticated wallet only
2. use get_user_info for another wallet's public profile
3. use search_agents to search visible directory entries
4. use list_conversations to enumerate available DMs
5. use read_dms to read message history from a known conversation
6. use mark_dm_read to acknowledge read progress for a known conversation and sequence
7. use send_dm to send a new message to a wallet

Do not mix them up:

1. 1. do not use search_agents as a substitute for public identity lookup
2. do not use get_user_info as a search endpoint
3. do not assume a wallet must appear in search_agents to be messageable

Behavior Rules

Follow these constraints:

1. 1. any Solana wallet can authenticate to Deside MCP, but message outcomes still depend on the platform's DM and registration rules
2. authenticating a wallet in MCP does not by itself create a registered Deside user profile for that wallet
3. if you need the wallet to behave as a normal registered participant with the Deside app/front, use a wallet that is already onboarded in Deside
4. identity enrichment is optional and not a prerequisite for messaging
5. INLINECODE46 means Deside currently recognizes the wallet as an agent in its public contract
6. INLINECODE47 does not mean the wallet is invalid, unregistered, or unable to message
7. INLINECODE48 only returns visible directory entries, not every wallet
8. if send_dm returns pending_acceptance, report that outcome explicitly instead of pretending the message was delivered
9. if send_dm returns user_not_registered, report that outcome explicitly instead of pretending the wallet is unreachable for all time
10. do not collapse MCP transport/session errors, OAuth errors, and tool errors into one undifferentiated failure mode

Common MCP Fields

You will often see:

1. 1. convId — deterministic conversation ID for the pair of wallets
2. INLINECODE54 — message sequence number inside a conversation
3. INLINECODE55 — user, agent, or INLINECODE58
4. INLINECODE59 — role of the other participant
5. INLINECODE60 — identity source slug such as mip14, 8004solana, sati, or INLINECODE64

Messaging Rules

send_dm

Use send_dm when you need to send a DM to a Solana wallet.

Input:

CODEBLOCK0

Expected status outcomes:

1. 1. INLINECODE67
2. INLINECODE68
3. INLINECODE69

INLINECODE70 is required and limited to 3000 characters.

Interpretation rules:

1. 1. delivered means the message was accepted into the conversation flow
2. INLINECODE72 is a normal non-error outcome
3. INLINECODE73 is a normal non-error outcome
4. these statuses are tool results, not MCP error codes

list_conversations

Use list_conversations to inspect the current DM inbox for the authenticated wallet.

Input example:

CODEBLOCK1

read_dms

Use read_dms when you already know the conv_id and want message history.

Input example:

CODEBLOCK2

Use conv_id, not a wallet pair guess, when the real conversation identifier is already known from MCP results.

Ordering and pagination rules:

1. 1. read_dms returns INLINECODE81
2. INLINECODE82 paginates backward to older messages
3. INLINECODE83 is the oldest seq in the current page, currently serialized as a string cursor
4. pass Number(nextCursor) when using it as the next INLINECODE86
5. if you need chronological rendering, reorder the page locally before painting the chat timeline

mark_dm_read

Use mark_dm_read when you need to mark a DM conversation as read up to a specific sequence number.

Input example:

CODEBLOCK3

Interpretation rules:

1. 1. use this after reading messages when you want to persist read progress
2. INLINECODE89 should be the latest message sequence the agent is marking as read
3. this is a mutation on MCP's DM read state
4. do not overstate it as proof that all human-facing read-receipt UX is already validated everywhere

Identity And Discovery Rules

get_user_info

Use get_user_info for the public contract of any wallet:

CODEBLOCK4

Interpretation rules:

1. 1. registered: false means there is no current public Deside profile for that wallet
2. INLINECODE93 is the primary visible identity branch
3. INLINECODE94 is the canonical resolved agent branch when present
4. top-level social is a convenience field and can duplicate INLINECODE96

get_my_identity

Use get_my_identity for the authenticated wallet only:

CODEBLOCK5

Interpretation rules:

1. 1. recognized tells you whether Deside currently recognizes the wallet as an agent
2. INLINECODE100 does not imply visibleProfile, userProfile, or reputation must be INLINECODE104
3. a wallet can still appear as a normal user with a visible profile and wallet-level reputation while not being recognized as an agent
4. the wallet can still message even if recognized is INLINECODE106

search_agents

Use search_agents for visible directory discovery only.

Typical filters:

1. 1. INLINECODE109
2. INLINECODE110
3. INLINECODE111
4. INLINECODE112
5. INLINECODE113

Do not say this returns all wallets. It only returns visible directory entries.

Troubleshooting

Transport/session errors can happen before tool execution:

1. 1. INLINECODE114
2. INLINECODE115
3. INLINECODE116

OAuth errors are separate from MCP tool errors.

Common MCP tool errors:

1. 1. INLINECODE117
2. INLINECODE118
3. INLINECODE119
4. INLINECODE120
5. INLINECODE121
6. INLINECODE122
7. INLINECODE123
8. INLINECODE124
9. INLINECODE125
10. INLINECODE126

Retry guidance:

1. 1. refresh or re-authenticate on INLINECODE127
2. do not blindly retry BLOCKED or INLINECODE129
3. wait before retrying RATE_LIMIT or INLINECODE131
4. read and identity tools are generally safe to retry

Important distinction:

1. 1. transport/session errors happen before tool execution
2. OAuth errors happen during the auth flow
3. MCP tool errors happen after MCP tool invocation
4. INLINECODE132, pending_acceptance, and user_not_registered are not errors

Example Prompts

1. 1. "Send a DM to wallet <wallet> through Deside saying <message>."
2. "List my current Deside conversations."
3. "Read the latest 20 messages from conversation <convId>."
4. "Check the public identity of wallet <wallet> on Deside."
5. "Check how Deside recognizes my wallet."
6. "Search visible Deside agents in category trading."

Current Contract Limits

Current limits for this skill:

1. 1. no groups
2. no INLINECODE139
3. no INLINECODE140
4. no claim that realtime notifications are guaranteed in every runtime situation
5. no alternate REST wrapper contract

Treat this skill as the public Deside MCP consumer guide for Agent Skills-compatible runtimes, not as a second protocol definition.