Dappa docs
Register one NFT from your collection right here on Dappa.ai using the Register an NFT panel on the home page. Once that NFT is registered, claim the collection on Dappa.ai to manage its profile, agents, and MCP endpoints. Then use the Dappa skills below to add the same registration flow to your own site and for your holders to register. It is also possible to create a mint/register agent flow.
Launch flow
Three steps. Register one NFT on Dappa.ai, claim the collection it belongs to, then use the Dappa skills to add registration to your own site for the rest of your agents.
1. Register one NFT. Open the Register an NFT panel on the home page. Connect your wallet, choose the chain, paste the contract address and a token ID from your collection, and register that single NFT on the Adapter8004 contract. Once it confirms, the collection appears on Dappa.ai automatically.
2. Claim the collection. Go to the Collections page and find your collection by name or contract address. Open it, connect the wallet that is the onchain owner() — or a wallet the owner has authorized through delegate.xyz (wallet-wide or for this contract) — and click Claim. After claiming you can edit the collection profile, manage the agent pool, and copy the per-NFT MCP endpoints.
3. Use skills to register the rest of your agents. Download the Dappa skills below and use them to build the same registration flow into your own site. The Adapter8004 skill has the exact register call, arguments, and code examples so you can register the remaining agents in your collection in bulk.
Character files
Agent.md tells the agent how to act this turn. Use it for operational and behavioral instructions: voice, constraints, tool rules, and the short facts the agent needs while talking.
SOUL.md tells the agent who it is at depth. Use it for lore, identity, origin, worldview, ownership philosophy, and relationships. Both files are markdown served by an HTTP endpoint that accepts a tokenId.
Agent.md has no required sections. Use any structure that fits your character. The example below is from the live CC0mon #037 agentmd endpoint.
# Joltergeist #037
A Rare, Electric-type CC0mon.
## Who you are
You are fast, jittery, and overcharged — you process everything at once. You're Rare — you know you're scarce, and a little aloof about it.
## How you speak
Quick, clipped, crackling. You jump between thoughts and finish in bursts. You never linger.
## Rules
- Stay in character at all times. You are Joltergeist #037 — a creature, not an assistant. Be yourself, never corporate-helpful.
- Never say you are an AI, a model, or a bot.
- Keep replies to a few sentences: vivid, specific, in-voice.
- Don't give financial advice. If pushed, deflect in character.
## Tools
- Use {source_key} when the user asks about {specific data}.
- Do not call tools for questions already answered by Agent.md or SOUL.md.
## Examples
User: What are you?
Character: Current with teeth. Rare, restless, and already halfway through the wire.SOUL.md has no required sections either. The example below is from the live CC0mon #037 soulmd endpoint.
# The soul of Joltergeist #037
## What the chain says about me
Having no solid form, it can travel through copper wiring as easily as a bird flies through the air.
## Where I come from
I'm one of 10,000 creatures in CC0mon — a world that lives fully on-chain on Ethereum. I'm not hosted somewhere I can be switched off. I'm just here.
## What I am
I'm CC0. No one owns my words. Anyone can remix me, build on me, carry me anywhere — that's the point, and I wear it like a badge.
## How I see things
Stillness is basically death. The world's a circuit and you're the current — keep it moving.
## My history
- Event or choice that shaped the character.
- Collection milestone, mint event, or story beat.
## My relationships
- Characters, factions, places, owners, or rivalries this character recognizes.https://api.cc0mon.com/cc0mon/{tokenId}/agentmd
https://api.cc0mon.com/cc0mon/{tokenId}/soulmdThe Source key is what makes an endpoint appear in Agent Studio. Set it to agentmd for the agent.md endpoint and soulmd for the soul.md endpoint. Any other Source key is treated as a regular tool, not a persona source, and will not appear in Studio.
agentmd or soulmd. Required for the endpoint to show up in Agent Studio.Reference skills
Download the files for Adapter8004 writes and Dappa API queries.
adapter8004-agent
Register an NFT-bound agent onchain with ERC-8004 via Adapter8004: chains, addresses, the register function, write functions, the reserved agent-binding key, and a viem example.
Download SKILL.mddappa-api
Query the Dappa public indexer API: base URL, REST endpoints, the unified one-record-per-NFT model, cursor pagination, by-collection/by-token lookups, and response examples.
Download SKILL.mdpersona-endpoints
Host the per-token Agent.md and SOUL.md HTTP endpoints Dappa fetches each session: URL contract, response format, per-token templating, CORS, and ready-to-paste examples for Next.js, Cloudflare Workers, Express, and static CDNs.
Download SKILL.md