ASMP
Menu

Guides

Ship with your software

Practical guide — add asmp.yaml to your repo and get discovered.

1. Copy the template

asmp: "0.1"
kind: service
name: my-service
description: What this does in one line
version: "0.1.0"
section: tools

capabilities:
  provides:
    - tools.my-service

endpoints:
  - protocol: http
    host: 127.0.0.1
    port: 8080
    visibility: loopback

Save as asmp.yaml at your repo root.

2. Name capabilities honestly

Use {domain}.{action} — agents query exact matches first.

email.classify
dns.cloudflare
docs.static

3. Trigger discovery

Passive: wait for host scan (default every 5 minutes).

Active:

curl -X POST http://127.0.0.1:7700/discover/scan

On start: daemon calls POST /services/announce with its manifest.

4. Verify

curl "http://127.0.0.1:7700/capabilities?provides=tools.my-service"
curl http://127.0.0.1:7700/services/my-service

Check source points at your repo file.

5. Wire agents

See Ambient discovery for global MCP setup.