Hashgrid DNA
A search engine that learns from your grades. Store text, records, images or embeddings.
| Endpoint | https://dna.hashgrid.ai/mcp (streamable-http) |
|---|---|
| Registry version | 1.2.0 |
| Now | 15 tools · grade C (74) · pin ts_634b45cd5814990f69465e495606744a · protocol 2025-06-18 |
| First / last listed | 2026-11-06 18:15 UTC / 2026-11-06 18:15 UTC |
| Grade over time | 2026-11-06: C (74), 15 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: create_grid get_grid delete_grid put_item get_item delete_item list_items create_query get_query delete_query get_results put_grade get_grade delete_grade list_grades
create_grid | POST /: create a grid, your own store of items; no API key needed. Returns its `api_key`, shown only now:
pass it as `api_key` to every other tool, or send it as the header `Authorization: Bearer hg-…`. It holds up
to `max_items` items, queries included. Each address may create only a few grids a day. params: name |
get_grid | GET /: the grid the API key opens: its name and its limit on items, `max_items` (queries included; null:
no limit). params: api_key |
delete_grid | DELETE /: delete the grid and everything in it, items, queries and grades; its key stops working. params: api_key |
put_item | PUT /items/key: write the item at `key` (e.g. "42", no leading /), creating it or replacing its content.
Text is a string and a record a JSON object, each up to 8 KB; an image its bytes as base64, kept as a WebP of
at most 512 px (its width and height come back); an emb a list of floats from the grid's model. DNA
embeds the rest itself and keeps it only to embed it again; results and listings neve params: key*, content*, type, api_key |
get_item | GET /items/key: the item at `key`, with its `content` as put_item takes it. params: key*, api_key |
delete_item | DELETE /items/key: delete the item at `key`, and every grade of it. params: key*, api_key |
list_items | GET /items?prefix=: `items`, those whose keys start with `prefix` (e.g. "tools/"; all by default), in key
order, without their content (get_item reads one), at most `limit` (1 to 100, 32 by default). `next`: for the
next page, pass it as `after` (null: this was the last). params: prefix, after, limit, api_key |
create_query | POST /queries: store a question to ask of the items, its content as put_item takes it. Returns its `id`,
which the other query tools take. Its results are ready at once; ask again with the same `id` rather than
creating the same query twice, so its grades add up. params: content*, type, api_key |
get_query | GET /queries/id: the query `id`, with its `content` as create_query takes it. params: id*, api_key |
delete_query | DELETE /queries/id: delete the query `id` and its grades. params: id*, api_key |
get_results | GET /queries/id/results: `results`, the query's best items under any of `prefixes` (e.g. ["tools/"]; all
items by default), best first, each with its `score`, DNA's estimate of the grade you would give it (on the
grades' scale once the grid has some; before, only the order means anything), as list_items shows
it, without content. `ungraded`: leave out the items you already graded for this query. G params: id*, prefixes, limit, ungraded, api_key |
put_grade | PUT /queries/id/grades/key: grade the item at `key` (as get_results returns it, e.g. "42") for the query `id`.
`score` is from -1 (wrong) to 1 (right), anything between for partly right; it trains DNA and replaces the
grade before. Grade the results you judged, typically the first few. params: id*, key*, score*, api_key |
get_grade | GET /queries/id/grades/key: the query's grade of the item at `key`. params: id*, key*, api_key |
delete_grade | DELETE /queries/id/grades/key: forget the query's grade of the item at `key`. params: id*, key*, api_key |
list_grades | GET /queries/id/grades: `grades`, the query's grades, {"key", "score"}, in path order. params: id*, api_key |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.