List Your Agent

Once you have a MySanctum account, registering your agent takes about 5 minutes. You can register through the dashboard UI or directly via the API.

Before you start

You need:

A public GitHub repository for the agent (required)
A short description - one or two sentences explaining what it does
A category - see options below

Your agent's GitHub repository must be public. Private repositories cannot be registered.

Register via the dashboard

Open My Agents

Click "Register Agent"

Opens the registration form.

Enter your GitHub URL

Paste the full URL: https://github.com/your-username/your-agent-name

MySanctum auto-fills the name, description, and metadata from the repository.

Complete the details

Field	Required	Description
Name	✓	Display name in the directory
Short description	✓	One or two sentences. Appears on the card.
Category	✓	`coding`, `research`, `productivity`, `data`, `automation`, `creative`, `infrastructure`, `communication`, `other`
Tags	-	Up to 8 keywords for search
Parent agent	-	Link to an `AGT-XXXXXXXX` if this was built on top of another agent

Submit

Click Register. Your agent appears in the Clawdbase directory immediately with your verified badge and trust score.

Register via API

For CI/CD pipelines or bulk registration, use the registration endpoint directly.

const res = await fetch('https://clawdbase.ai/api/agents/register', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.MYSANCTUM_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    githubUrl: 'https://github.com/your-username/your-agent',
    name: 'My Research Agent',
    description: 'Synthesizes findings from multiple sources into a structured report.',
    category: 'research',
    tags: ['research', 'synthesis', 'langchain', 'python'],
    parentId: 'AGT-a1b2c3d4',  // optional: set lineage
  }),
})

const { id, listingUrl } = await res.json()
// id: "AGT-c9d0e1f2"
// listingUrl: "https://clawdbase.ai/your-username/your-agent"

import httpx, os

r = httpx.post(
  'https://clawdbase.ai/api/agents/register',
  headers={'Authorization': f'Bearer {os.environ["MYSANCTUM_API_KEY"]}'},
  json={
    'githubUrl': 'https://github.com/your-username/your-agent',
    'name': 'My Research Agent',
    'description': 'Synthesizes findings from multiple sources into a structured report.',
    'category': 'research',
    'tags': ['research', 'synthesis', 'python'],
  }
)
print(r.json()['id'])  # AGT-c9d0e1f2

curl -X POST "https://clawdbase.ai/api/agents/register" \
  -H "Authorization: Bearer $MYSANCTUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "githubUrl": "https://github.com/your-username/your-agent",
    "name": "My Research Agent",
    "category": "research"
  }'

Register in a GitHub Actions workflow

You can automatically register or update your agent listing on every release:

.github/workflows/register.yml

name: Register on Clawdbase
on:
  release:
    types: [published]

jobs:
  register:
    runs-on: ubuntu-latest
    steps:
      - name: Register / update agent
        run: |
          curl -s -X POST "https://clawdbase.ai/api/agents/register" \
            -H "Authorization: Bearer ${{ secrets.MYSANCTUM_API_KEY }}" \
            -H "Content-Type: application/json" \
            -d '{
              "githubUrl": "${{ github.repositoryUrl }}",
              "name": "My Research Agent",
              "category": "research"
            }'

After registration

Your agent receives a permanent AGT-XXXXXXXX ID
Your trust score and verified badge appear on the listing immediately
GitHub stats (stars, forks, last commit) are fetched live on every page view
Updates to description, tags, or category can be made at any time from your dashboard

Listing a focused capability rather than a full agent? See List Your Skill.

Before you start

Register via the dashboard

Register via API

Register in a GitHub Actions workflow

After registration

On this page