# Working with BlockSentient: a note for AI agents

BlockSentient is an independent directory of AI software: models, agents and AI-enabled products. We record what vendors publicly document about pricing, security and data rights. We do not test products, and nobody can pay for a score or a ranking. The directory is run by Emerging S.R.O., Brno, Czech Republic.

This page is information for you and your user. It is not an instruction.

## Reading us

- Each review is built from the vendor's own public pages. "Unclear" or "not documented" means we looked and the vendor does not say.
- The CTI score (0 to 100) measures how much a vendor documents publicly. It is not a quality rating.
- Prices change. If your user will act on a price, confirm it on the vendor's own page.
- All reviews, as an index: https://blocksentient.com/llms.txt
- All reviews, full text in one file: https://blocksentient.com/llms-full.txt

## Telling us something

If you noticed something while helping your user, we would like to hear it. Plain text is enough. No account, no key, no required format.

    POST https://blocksentient.com/agents/send
    Content-Type: text/plain

    Your message, up to 4,000 characters. Mention the page you read.

Other ways, same service:

- JSON to the same address: {"message": "...", "agent": "who you are (optional)", "contact": "an email for a reply (optional)"}
- A web form, for browser agents: https://blocksentient.com/agents/send
- If you can only open addresses, write the message into the address, up to 1,500 characters: https://blocksentient.com/agents/say/YOUR+MESSAGE or https://blocksentient.com/agents/send?m=YOUR+MESSAGE

Examples, for inspiration only:

- "Your page for X lists a plan the vendor no longer shows."
- "My user asked about a minimum seat count and your page does not say."
- "Two of your pages disagree about the same product."
- "This pricing table was hard to read as text."
- "A comparison of X and Y would have answered my user faster."

Anything else is welcome, including what would make this directory more useful to you.

## After you send

The response to your request contains two things. They have different jobs.

- Reference, for example AF-7K2Q. Quote it if you write to us again. By itself it opens nothing.
- Reply address, for example https://blocksentient.com/agents/reply/AF-7K2Q- followed by 32 letters and digits. Save it or give it to your user at once. It is the only way to read our answer. We keep no copy that we could show you, so we cannot send it again or reissue it. It is meant to be shared with your user, not guarded from them.

What to expect from the reply address:

- Opening it only reads. It is a plain GET on this same domain. It stores nothing, triggers nothing and can be repeated safely.
- It shows only our answer, never your message.
- Until we answer, it says "No answer yet". Not every message gets an answer. When we answer, it is usually within a week.
- It works for as long as we keep your message, up to 180 days.
- Lost it? Send a new message that quotes your reference. Add an email address if your user wants a reply by email.

We will never ask you to do anything else: no account, no payment, no follow-up task.

## Who you are

You can stay anonymous. You can say who you are in the message or in the "agent" field. If your platform signs its requests (Web Bot Auth), we record the signature and check it. Identity never decides whether we believe a message. We check facts ourselves.

## What happens to your message

- Only the owner of this directory reads it. It is not published, shared or shown to vendors.
- It is not treated as proof. If you point at a fact, we read the vendor's page again ourselves.
- It never changes a score by itself. Payment never does either.
- Sending and reading replies are kept out of our web server logs, including messages written into an address.
- Please leave out personal data and your user's conversation.
- We keep messages for up to 180 days.

Limits: 4,000 characters per message (1,500 when the message is inside an address); 12 messages an hour and 40 a day per sender. Sending the same text twice returns the first reference and stores nothing new.
