PointRover for your assistant
On this page
- What PointRover gives your assistant
- Connect it
- Tools
- Before you connect
- Errors
- Help and privacy
What PointRover gives your assistant
The books record what has already happened. PointRover gives the assistant the world
the business sits in: the industry and where the business stands in it, every input it
buys and what is moving upstream of it, the duties on what it imports, the rules it
answers to, and what its region pays and spends. Every figure links to the record it
came from, and the assistant can cite it.
Connect it
PointRover is a remote MCP server at one address.
The address
https://pointrover.com/mcp
In Claude, open Settings, then Connectors, and choose Add custom connector. Paste the
address, sign in with your PointRover account, and pick the business this connection
reads. Each connection reads one business.
Claude, Add custom connector
Name: PointRover
Remote MCP server URL: https://pointrover.com/mcp
Any other MCP client uses the same address. The server speaks Streamable HTTP and signs
clients in with OAuth 2.1, using the authorization code flow with PKCE and dynamic
client registration, so a client that supports MCP authorization finds the sign-in
settings at the address. The configuration file's name and keys vary by client.
A client configuration file (mcp.json)
{
"mcpServers": {
"pointrover": {
"type": "http",
"url": "https://pointrover.com/mcp"
}
}
}
There are nine tools, and every one of them only reads.
Who Am I Connected As whoami
Returns which business this connection is for, whether its figures are ready, and what industry it is in, decided or still provisional. An assistant calls it when it is starting work for the owner.
No parameters.
Example
whoami({})
Business Brief pointrover_brief
Returns one summary of what is moving upstream of what the business buys, the tariff alerts open now, the events reaching it and rules with a date coming up. An assistant calls it when it is getting up to speed before a purchase.
No parameters.
Example
pointrover_brief({})
Changes Since pointrover_changes_since
Returns what moved since an earlier answer: newly published figures upstream of the business, and recalls, storms or trade actions that opened, changed or ended. An assistant calls it when it is coming back to the business after a few days.
| Name | Type | Required | What it is |
since | string | yes | The board_version from an earlier answer, or a check id from Events Near the Business. |
Example
pointrover_changes_since({"since": "<board_version>"})
Events Near the Business pointrover_events
Returns the recalls, weather alerts, disaster declarations and trade actions reaching the business's locations or what it buys, each in its publisher's words, with how closely it touches the business. An assistant calls it when it is checking a storm or a recall.
| Name | Type | Required | What it is |
since | string | no | Only events opened after this check id or date. |
min_exposure | number | no | Only events tied to the business at least this closely. |
min_coverage | number | no | Only events that touch at least this share of what they reach. |
min_weight | number | no | Only events whose combined weight is at least this. |
kinds | array | no | Only these event types, such as weather_watch or trade_action. |
all | boolean | no | true lists the events the default answer only counts. |
sources | boolean | no | true adds when each source of events was last checked. |
Example
pointrover_events({"kinds": ["<event type>"]})
Search the Board search
Returns the inputs and their published indexes, tariffs, wages, locations, rules and events PointRover holds for the business that match a few words, each with an id and title. An assistant calls it when it is looking up one input or duty.
| Name | Type | Required | What it is |
query | string | yes | The words to look for. |
limit | integer | no | How many results, from 1 to 25. 10 if left out. |
scope | string | no | business for the business's own records (the default), industry for what its industry typically buys and sells, all for both. |
Example
search({"query": "<words>", "limit": <number>})
Fetch a Record fetch
Returns everything PointRover holds on one item: its latest figure, its change over a year and how unusual that is, its receipt handle and the events touching it. An assistant calls it when it is opening an id another tool returned.
| Name | Type | Required | What it is |
id | string | yes | An id another tool returned. |
detail | string | no | concise (the default); full to add related records and history; origins for where an imported good comes from and the duties on it. |
page | integer | no | Which page of a long event record. 1 if left out. |
Example
fetch({"id": "<id>"})
Published Index Series pointrover_series
Returns the published index for one input the business buys or one wage it pays: the latest figure, its twelve-month move and how unusual that move is. An assistant calls it when it is checking one material's trend.
| Name | Type | Required | What it is |
series_id | string | yes | The publisher's own id for the series. |
window | integer | no | How many recent periods to look at. Every period the board holds if left out. |
include_observations | boolean | no | true adds the figure for each period. |
Example
pointrover_series({"series_id": "<series_id>"})
Receipt for a Figure pointrover_receipt
Returns where one figure came from: the publisher's link, the survey behind it, what it measures and how to check it by hand. An assistant calls it when it is showing where a number came from.
| Name | Type | Required | What it is |
receipt_id | string | yes | The receipt id another tool returned with the figure. |
Example
pointrover_receipt({"receipt_id": "<receipt_id>"})
Walk the Graph pointrover_graph
Returns many connected pieces at once, such as what the business buys and what is upstream of it, its wages, rules and locations, and how each links to the next. An assistant calls it when it is weighing many things at once.
| Name | Type | Required | What it is |
start | string | no | The id to start from. The business itself if left out. |
edges | array | no | Which kinds of link to follow. |
depth | integer | no | How many links out to go, from 1 to 3. 1 if left out. |
where | array | no | Up to four filters; a record that matches any one is kept. |
detail | string | no | concise (the default) or full. |
token_budget | integer | no | The most tokens the answer may use, from 200 to 12,000. 3,000 if left out. |
Example
pointrover_graph({"start": "<id>", "depth": <1 to 3>})
Reading demand figures
The business's own record lists, for the county of each of its sites, the published figures for its own industries and for the industries that buy from it: County Business Patterns, the 2022 Economic Census and, where it is out, QCEW. Each figure is the publisher's number with its period, its release date, the next release expected and a receipt. A suppressed or withheld figure is shown that way, with the broader figures beside it, and is never filled in. Nothing here is estimated, ranked, sorted or multiplied.
A reader can work some things out from them. A location quotient: QCEW publishes its own, and a shift-share needs two releases. Penetration: the business's own sales over the county's households or establishments. A retail gap: Economic Census sales against households times a national average from the Consumer Expenditure Survey, which is an allocation and not a measured market. And the RIMS II rule, min(LQ, 1) × use share, which undercounts trade where a county both buys and sells the same goods.
Before you connect
You need a PointRover account, made at pointrover.com, with at
least one business added and its board built. A first build takes about an hour.
Pricing is on the pricing section of pointrover.com.
The assistant sees only the businesses in your workspace, and each connection reads the
one business you picked when you signed in.
Errors
When a call fails, the answer is a sentence that says what to do. The common ones are below.
| What the assistant sees | What to do |
| Sign in to PointRover in your MCP client to use this tool. | Connect again and sign in with your PointRover account. |
| This business has no board yet. Builds finish in about an hour; call pointrover_brief again then. | Wait for the first build, then call it again. |
| No record with id "<id>" is on this board. Ids come from search, pointrover_brief or pointrover_graph. | Use an id one of those tools returned for this business. |
| Board version "<board_version>" is no longer served: versions are kept 8 days. Call pointrover_brief for the current version and pass that. | Read the brief again and use the board_version it returns. |
| A sentence naming a parameter, such as: search needs a "query". | Fix that parameter and call again; the sentence says what it takes. |
| PointRover answered this call with an error (ref <ref>). Try again; if it repeats, write to mike@pointrover.com with the ref. | Try once more. If it fails again, send us the ref. |
Help and privacy
Write to mike@pointrover.com with a question
about connecting or about a figure.
The connector reads your businesses' boards and nothing else. It writes nothing, and it
never reads your assistant's memory, chat history or files. What we collect, and why, is
in the privacy policy. The
terms of service cover use of the service.