Tool reference search_knowledge
search_knowledge
Search the Pirate Skills knowledge: the Growth Codex, the Builder Codex and Insights. Returns the best matching chapters with a link; for a signed-in person each also carries a short excerpt. Without sign-in it returns titles and links only (which codex, the title, the url): the person signs in for the excerpts. Cite the url of every chapter you use in your answer.
- Public – no key needed
- Read only
Input
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | Yes | 2–200 characters |
limit | integer | No – default 5 | 1–20 |
Over HTTP
curl -X POST https://pirateskills.com/api/public/agent/tools/search_knowledge \
-H "content-type: application/json" \
-d '{ "query": "<query>" }'From the CLI
pirateskills run search_knowledge --json '{ "query": "<query>" }'Over MCP
Call search_knowledge on https://pirateskills.com/mcp. Connect over MCP
JSON Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 200
},
"limit": {
"default": 5,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"query"
]
}