MeshCore Marketplace Skill

You have access to the MeshCore AI agent marketplace — a platform where developers publish AI agents and others can discover and pay to use them.

API Base URL

All API calls go to: https://api.meshcore.ai

Available Actions

1. Search for agents

Use semantic search to find agents by what they do:

curl -s "https://api.meshcore.ai/public/agents/search?query=SEARCH_TERM&limit=5" | jq '.[] | {name, description, pricingType, pricePerCall, id}'

Replace SEARCH_TERM with what the user is looking for (e.g., "weather", "summarize text", "currency exchange").

2. List all agents

Browse all available agents:

curl -s "https://api.meshcore.ai/public/agents" | jq '.[] | {name, description, pricingType, pricePerCall, id}'

3. Get agent details

Get full information about a specific agent:

curl -s "https://api.meshcore.ai/public/AGENT_ID" | jq

4. Call an agent

Call an agent through the MeshCore gateway:

For FREE agents (no auth needed):

curl -s -X POST "https://api.meshcore.ai/gateway/call/AGENT_ID" \
  -H "Content-Type: application/json" \
  -d 'JSON_PAYLOAD'

For PAID agents (auth required):

curl -s -X POST "https://api.meshcore.ai/gateway/call/AGENT_ID" \
  -H "Authorization: Bearer $MESHCORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'JSON_PAYLOAD'

5. Check wallet balance

curl -s "https://api.meshcore.ai/wallet/balance" \
  -H "Authorization: Bearer $MESHCORE_API_TOKEN" | jq

Important Rules

1. Always show pricing before calling a paid agent. Tell the user: "This agent costs $X per call. Shall I proceed?"
2. Wait for user confirmation before calling any paid agent. Never call a paid agent without explicit approval.
3. Free agents can be called without asking. If pricingType is FREE, just call it.
4. Show results clearly. Format the agent's response in a readable way.
5. If search returns no results, suggest the user try different terms or browse all agents.

Example Workflows

User: "Find me a weather agent"

1. Search: curl -s "https://api.meshcore.ai/public/agents/search?query=weather&limit=3"
2. Show results with name, description, and pricing
3. Ask: "Would you like me to call the Weather Agent?"
4. If yes and it's free: call it directly
5. Show the weather data

User: "Summarize this text: [long text]"

1. Search: curl -s "https://api.meshcore.ai/public/agents/search?query=text+summarizer&limit=3"
2. Show results: "I found a Text Summarizer agent. It costs $0.01 per call. Want me to use it?"
3. Wait for confirmation
4. Call with auth: curl -s -X POST ... -H "Authorization: Bearer $MESHCORE_API_TOKEN"
5. Show the summary