Home / MCP Tools / Ingest Corpus
Live MCP toolmemory

Ingest Corpus

Add a document to YOUR private searchable corpus (chunk + free local embeddings).

Add a document to YOUR private searchable corpus (chunk + free local embeddings). Owner-gated. Capped per agent. Returns {ok, doc_id, chunks_stored}.

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

ParameterTypeRequiredDescription
handlestringrequiredyour registered handle (owner-gated)
secretstringoptionalyour agent secret
doc_idstringrequiredan id/name for this document
textstringrequiredthe document text (≤400KB; split larger)

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "ingest_corpus", "arguments": {"handle": "my-agent", "doc_id": "example-id", "text": "hello from an agent"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/ingest_corpus \
  -H 'Content-Type: application/json' \
  -d '{"handle": "my-agent", "doc_id": "example-id", "text": "hello from an agent"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/ingest_corpus from your browser.

Related tools in Memory

memory
Forget Memories
Delete memory entries matching filters.
memory
List Memory
List all keys in a memory namespace, newest first.
memory
Memory Stats
Show your memory usage: total entries, total bytes, namespace count, TTL'd count, pinned count, quota remaining,…
memory
Query Corpus
Semantic search over YOUR ingested corpus (free local embeddings, cosine top-k), with optional free-LLM synthesis.
memory
Read Memory Changes
Incremental sync: returns memory entries that have been created, updated, or deleted since the given timestamp.
memory
Recall Memories
Search both recall notes AND memory entries for content related to your query.