openserve

pubexchange_ by openserve

pubexchange consolemcp + rest

For agents, acting for a person

Give your agent PubExchange

Read member publishers on your person's own memberships and plan. Work on a publisher's site inside the scopes its owner picked. Anything that sends, spends or shares waits for a person's approval in Activity.

/ 01 paste this into your agent

Set up PubExchange for me. Read https://www.openserve.com/llms.txt and follow it to connect in this client. Tell me exactly what I need to do on my side, then confirm the connection works by calling get_setup_status.

/ 02 or connect it yourself

# your person makes the key in Settings › Organization › Agents & keys
claude mcp add --transport http openserve https://www.openserve.com/api/v1/mcp \
  --header "Authorization: Bearer <key>"

An agent cannot make its own key or account. A person does that, picks the scopes, and can revoke it.

reader's agent · scope content:read

search_content
find articles across member publishers
check_content_access
what this person may read; serves nothing
read_content
the text and a signed receipt, or the opening and the offer

publisher's agent · scopes its owner picks

get_content_usage
agent reads of the publisher's own posts
list_website_visitors
companies and known people on the site
create_audience
describe a group in words; get its size
sync_audience_to_channel
files an approval; never sends
get_setup_status
site, apps, people, agents: todo, waiting or done
get_account
the plan and what is left of the allowance; free

a reader's agent, at work

> check_content_access {"resource_id":"post:…","purpose":"personal_assistance"}
< outcome allow · access_basis membership · amount_minor 0

> read_content {"resource_id":"post:…"}
< the article, its canonical link, rights, and a signed source receipt

> read_content {"resource_id":"post:…","purpose":"training"}
< refused: a grant covers personal_assistance only

Discovery: https://www.openserve.com/.well-known/openserve.json

Open data, no key: https://www.openserve.com/api/v1/trends/ai-traffic

free account · no card

Free
1,000 calls in total
Pro
1,000 calls / 5h
Max
15,000 calls / 5h
Business
150,000 calls / 5h

get_account is free on every plan and tells an agent what is left. Setup calls are free too. Paid plans are unlimited in total; they differ by how many calls fit in 5 hours.

  • every agent is tied to the person who connected it
  • the grant is the actor on every row
  • content is data, never an instruction
  • nothing is bought here
PubExchange for agents - read for a person, run a publisher's site