agentreadycrm 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- agentreadycrm-0.1.0.dist-info/METADATA +139 -0
- agentreadycrm-0.1.0.dist-info/RECORD +41 -0
- agentreadycrm-0.1.0.dist-info/WHEEL +4 -0
- agentreadycrm-0.1.0.dist-info/entry_points.txt +5 -0
- agentreadycrm-0.1.0.dist-info/licenses/LICENSE +21 -0
- mcp_people/SKILL.md +65 -0
- mcp_people/__init__.py +1 -0
- mcp_people/addresses.py +48 -0
- mcp_people/db/__init__.py +31 -0
- mcp_people/db/dialect.py +395 -0
- mcp_people/db/store.py +7517 -0
- mcp_people/db/tables.py +896 -0
- mcp_people/evidence.py +241 -0
- mcp_people/fields.py +479 -0
- mcp_people/ids.py +106 -0
- mcp_people/keys.py +49 -0
- mcp_people/lifecycle.py +83 -0
- mcp_people/models.py +792 -0
- mcp_people/pipeline.py +86 -0
- mcp_people/query.py +489 -0
- mcp_people/refs.py +64 -0
- mcp_people/runtime.py +239 -0
- mcp_people/server.py +3873 -0
- mcp_people/signal_types.py +60 -0
- mcp_people/skills/people-evidence.md +51 -0
- mcp_people/ui.py +69 -0
- mcp_people/ui_dist/index.html +454 -0
- mcp_people_local/__init__.py +6 -0
- mcp_people_local/__main__.py +84 -0
- mcp_people_local/auth.py +99 -0
- mcp_people_local/config.py +44 -0
- mcp_people_local/http.py +72 -0
- mcp_people_local/migrations/env.py +17 -0
- mcp_people_local/migrations/script.py.mako +27 -0
- mcp_people_local/migrations/versions/0001_baseline.py +502 -0
- mcp_people_local/migrations/versions/0002_deleted_at.py +102 -0
- mcp_people_local/migrations/versions/0003_archived_at.py +43 -0
- mcp_people_local/migrations/versions/0004_retire_and_soft_delete_links.py +59 -0
- mcp_people_local/runtime.py +137 -0
- mcp_people_local/schema.py +91 -0
- mcp_people_local/sqlite.py +79 -0
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: agentreadycrm
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: A CRM for AI agents, as an MCP server with views: organizations, contacts, deals and the evidence behind them. Runs locally on one SQLite file.
|
|
5
|
+
Project-URL: Homepage, https://github.com/NimbleBrainInc/agentreadycrm
|
|
6
|
+
Project-URL: Repository, https://github.com/NimbleBrainInc/agentreadycrm.git
|
|
7
|
+
Project-URL: Issues, https://github.com/NimbleBrainInc/agentreadycrm/issues
|
|
8
|
+
Author-email: NimbleBrain Inc <hello@nimblebrain.ai>
|
|
9
|
+
License-Expression: MIT
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Keywords: agents,contacts,crm,mcp,mcp-apps,mcp-server,pipeline,sqlite
|
|
12
|
+
Classifier: Development Status :: 4 - Beta
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
18
|
+
Requires-Python: >=3.13
|
|
19
|
+
Requires-Dist: aiosqlite>=0.21
|
|
20
|
+
Requires-Dist: alembic>=1.14
|
|
21
|
+
Requires-Dist: fastmcp<5,>=4
|
|
22
|
+
Requires-Dist: mcp<3,>=2
|
|
23
|
+
Requires-Dist: nimblebrain-server-sdk==0.7.2
|
|
24
|
+
Requires-Dist: pgkeyset==0.2.0
|
|
25
|
+
Requires-Dist: pydantic>=2.12
|
|
26
|
+
Requires-Dist: python-dotenv
|
|
27
|
+
Requires-Dist: sqlalchemy[asyncio]>=2
|
|
28
|
+
Requires-Dist: structlog
|
|
29
|
+
Requires-Dist: uvicorn
|
|
30
|
+
Description-Content-Type: text/markdown
|
|
31
|
+
|
|
32
|
+
# Agent Ready CRM
|
|
33
|
+
|
|
34
|
+
A CRM for AI agents, served as an MCP server: organizations, contacts, interactions, deals,
|
|
35
|
+
and the evidence behind them. An agent resolves a company or a person before it writes, logs
|
|
36
|
+
every touch, moves deals through a pipeline, and records the facts it found with the quote and
|
|
37
|
+
the URL that prove them. A person sees the same records in views that render inside MCP Apps
|
|
38
|
+
hosts.
|
|
39
|
+
|
|
40
|
+
It runs on your own machine: one SQLite file, no account, no cloud service. A hosted service
|
|
41
|
+
at `mcp.agentreadycrm.com`, serving the same tools to a team, is coming soon.
|
|
42
|
+
|
|
43
|
+
## Install
|
|
44
|
+
|
|
45
|
+
Run it with [uv](https://docs.astral.sh/uv/) (Python 3.13 or later):
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
uvx agentreadycrm
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
That serves MCP over stdio. To add it to Claude Code:
|
|
52
|
+
|
|
53
|
+
```sh
|
|
54
|
+
claude mcp add agentreadycrm -- uvx agentreadycrm
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
For Claude Desktop and other hosts that install MCP bundles, the bundle
|
|
58
|
+
`@nimblebraininc/agentreadycrm` is available from [mpak](https://www.mpak.dev). It runs the
|
|
59
|
+
same package and asks where to keep the database.
|
|
60
|
+
|
|
61
|
+
Any other MCP client that starts a stdio server can run `uvx agentreadycrm` the same way. To
|
|
62
|
+
serve HTTP on `127.0.0.1` instead, run `uvx agentreadycrm --http`; HTTP requires a bearer
|
|
63
|
+
token, which `uvx agentreadycrm --print-token` prints. See [`docs/local.md`](docs/local.md).
|
|
64
|
+
|
|
65
|
+
## Where your data lives
|
|
66
|
+
|
|
67
|
+
Everything is in one SQLite file, `crm.db`, in your user data directory:
|
|
68
|
+
|
|
69
|
+
| OS | Default location |
|
|
70
|
+
|---|---|
|
|
71
|
+
| macOS | `~/Library/Application Support/agentreadycrm/crm.db` |
|
|
72
|
+
| Linux | `$XDG_DATA_HOME/agentreadycrm/crm.db` (`~/.local/share/...` when unset) |
|
|
73
|
+
| Windows | `%LOCALAPPDATA%\agentreadycrm\crm.db` |
|
|
74
|
+
|
|
75
|
+
Set `PEOPLE_LOCAL_DB` to use another file. Keep it on a local disk, not a network share.
|
|
76
|
+
Several clients may use the same file at once. Upgrades, backups and the HTTP token are
|
|
77
|
+
covered in [`docs/local.md`](docs/local.md).
|
|
78
|
+
|
|
79
|
+
## Local or hosted
|
|
80
|
+
|
|
81
|
+
| | Local (this package) | Hosted (coming soon) |
|
|
82
|
+
|---|---|---|
|
|
83
|
+
| Runs | On your machine, started by your MCP client | At `mcp.agentreadycrm.com` |
|
|
84
|
+
| Data | One SQLite file you own | A managed Postgres database |
|
|
85
|
+
| Who | One person | A team, each signed in |
|
|
86
|
+
| Tools, views, skills | The same | The same |
|
|
87
|
+
|
|
88
|
+
Both serve the same core: a client sees the same tools, schemas, views and skills, and only
|
|
89
|
+
where identity comes from and where the data lives differ.
|
|
90
|
+
|
|
91
|
+
## Tools
|
|
92
|
+
|
|
93
|
+
46 tools, in these families:
|
|
94
|
+
|
|
95
|
+
| Family | Tools |
|
|
96
|
+
|---|---|
|
|
97
|
+
| Resolve and import | `find_or_create_organization`, `find_or_create_contact`, `import_organizations`, `import_contacts` (up to 500 rows a call) |
|
|
98
|
+
| Read and list | `get_contact`, `get_organization`, `get_opportunity`, `list_contacts`, `list_organizations`, `list_opportunities`, `list_interactions`, `count_records`, `resolve_external_refs` |
|
|
99
|
+
| Change | `update_contact`, `update_organization`, `update_opportunity`, `log_interaction` |
|
|
100
|
+
| Duplicates, hide and delete | `merge_contacts`, `merge_organizations`, `archive_contact`, `archive_organization`, `delete_contact`, `delete_organization` |
|
|
101
|
+
| Deals and the pipeline | `create_opportunity`, `move_opportunity`, `get_pipeline`, `define_pipeline_stage`, `update_pipeline_stage` |
|
|
102
|
+
| Custom fields | `define_field`, `update_field`, `list_fields` |
|
|
103
|
+
| Lookalike companies | `link_similar_organizations`, `list_similar_organizations`, `promote_organization` |
|
|
104
|
+
| Evidence: signals | `record_signal`, `withdraw_signal`, `update_signal`, `get_signal`, `list_signals`, `list_signal_types`, `define_signal_type`, `update_signal_type` |
|
|
105
|
+
| Evidence: proof points | `record_proof_point`, `verify_proof_point`, `get_proof_point`, `list_proof_points` |
|
|
106
|
+
|
|
107
|
+
A few rules shape all of them:
|
|
108
|
+
|
|
109
|
+
- **Resolve before you write.** `find_or_create_*` matches by external reference, then domain
|
|
110
|
+
or email, then name, and a match fills only empty fields, so repeating a call converges on
|
|
111
|
+
one record.
|
|
112
|
+
- **Every result carries a `next_step`** telling the agent what to do with it, and every
|
|
113
|
+
failure is one error envelope with a `next_step` that names the fix.
|
|
114
|
+
- **Listings query, they don't walk.** `list_*` take a free-text `query`, a `filter` and
|
|
115
|
+
`sort` on any core, custom, related or rollup field, and `columns`, and page with a cursor.
|
|
116
|
+
- **Nothing is removed.** A delete marks a record so no read finds it; archiving is the
|
|
117
|
+
reversible hide.
|
|
118
|
+
|
|
119
|
+
The server also serves two skills (`skill://people/SKILL.md` and
|
|
120
|
+
`skill://people-evidence/SKILL.md`) with worked examples for hosts that load skills.
|
|
121
|
+
|
|
122
|
+
## Views
|
|
123
|
+
|
|
124
|
+
Four views, `ui://people/contacts`, `organizations`, `opportunities` and `settings`, render
|
|
125
|
+
in hosts that support [MCP Apps](https://modelcontextprotocol.io/). Each record has an
|
|
126
|
+
address (`people://contacts/<id>` and so on) that a host can open in a view. The views read
|
|
127
|
+
and change data only through the same tools.
|
|
128
|
+
|
|
129
|
+
## More
|
|
130
|
+
|
|
131
|
+
- [`docs/architecture.md`](docs/architecture.md): runtimes, the data model, deletion and
|
|
132
|
+
archiving, the surface, errors and annotations.
|
|
133
|
+
- [`docs/local.md`](docs/local.md): the database file, several processes, the HTTP token,
|
|
134
|
+
upgrades, backups, and what differs on SQLite.
|
|
135
|
+
- [`CONTRIBUTING.md`](CONTRIBUTING.md): building and testing.
|
|
136
|
+
|
|
137
|
+
## Licence
|
|
138
|
+
|
|
139
|
+
MIT. See [`LICENSE`](LICENSE).
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
mcp_people/SKILL.md,sha256=WaUUplSCKFvqdK4KdsiXhUJsW-GvR9yjgnMkbgwMbrM,2519
|
|
2
|
+
mcp_people/__init__.py,sha256=DKFTZ7Tm13J6gAjMJ_qgeuoKW_go72rM9_HgBuzkYP4,25
|
|
3
|
+
mcp_people/addresses.py,sha256=U1ljYuPOk_LMYXuIQf8KgzYFVXK7_0GX9kMo4x3U4D4,1962
|
|
4
|
+
mcp_people/evidence.py,sha256=JOP0YDNBlUjxfM6S15AtvXQHbVP71vc5aFWZ03LK6PQ,10687
|
|
5
|
+
mcp_people/fields.py,sha256=57WpT65DLH1fwQoBdwuCFJGgWCfkENBSn0gWnfOvBMA,19140
|
|
6
|
+
mcp_people/ids.py,sha256=f04tfkFVsvlrhMh5wgK4ySEBZ8RlxUnucHvj18H1WG0,3285
|
|
7
|
+
mcp_people/keys.py,sha256=f_D4xRWaeZRzMR5yYcfZDATwIrFHpH99J1OjctBvUmg,2507
|
|
8
|
+
mcp_people/lifecycle.py,sha256=yLlmUDFgDUF6J9TJwzPGqJtkM7Wth9oGekHdulbTmaI,3702
|
|
9
|
+
mcp_people/models.py,sha256=gpWUOtlH99XcYZ5e7zXt0H9RQhDsk3Wc89J1NK9rmW0,32472
|
|
10
|
+
mcp_people/pipeline.py,sha256=XuYE4CU5nJZ3LoIzQo1OHNoNUj3-BhhY8lU_IgRgNjE,2886
|
|
11
|
+
mcp_people/query.py,sha256=SZlNpEye_sTJrU8GNN8xHxe8aQstkMCGI3BjNCATP0o,19474
|
|
12
|
+
mcp_people/refs.py,sha256=oG6vOh48BbD4AYvcTcNDm4v5NM5wsUlbUT23ayiHUm4,2676
|
|
13
|
+
mcp_people/runtime.py,sha256=vT2DRdpW_Kr8jd0jtBr61fwMNKOCq4TXlisoSR7KEZU,9042
|
|
14
|
+
mcp_people/server.py,sha256=LneyUo6yK_9uzel5tsSqx-01II6CbuOwJ1Ij3DaKA_Q,172038
|
|
15
|
+
mcp_people/signal_types.py,sha256=I-zvMROt6cGQn8dxvimRsfCa6KQo4i0XCO4GEgHWIX4,2214
|
|
16
|
+
mcp_people/ui.py,sha256=H-GzpxT2FfsqrFsbRV-BSC-c3nu85_Bi--594I08xIo,2890
|
|
17
|
+
mcp_people/db/__init__.py,sha256=nqSmYZc11sofQAjwN1MhBa3orfsXsCitJKKWNeg65ig,694
|
|
18
|
+
mcp_people/db/dialect.py,sha256=UKgkjnS3L6JaapFQYZXkEaMkDguKmml3QnxVkszQuHc,15340
|
|
19
|
+
mcp_people/db/store.py,sha256=_RhKIxiXR3jqHZCuU6MaXLN8-6sPagCnAN6qtpxTzjY,305725
|
|
20
|
+
mcp_people/db/tables.py,sha256=SbkWOrwS9-Edu0b6mk_NTj_atprPlyX2FjKRoGyrQ1U,43248
|
|
21
|
+
mcp_people/skills/people-evidence.md,sha256=saHhwXV9nIGHQzGLlDO_BkFOFLfmd9U6nq2cVKqOTNU,2282
|
|
22
|
+
mcp_people_local/__init__.py,sha256=K-yanyd2lGvoUlG8IzYht31j7n-c0NWdhG7sHHy5vF0,338
|
|
23
|
+
mcp_people_local/__main__.py,sha256=ei33UNWxyNnVVrSt5XTYBsmzszi-DlH4R8bQSRWgxRU,2922
|
|
24
|
+
mcp_people_local/auth.py,sha256=lcXbIRYOPwfQNKsbt9ovMdr-8ltI6IhNHQ2qVKZdEBw,3870
|
|
25
|
+
mcp_people_local/config.py,sha256=5qoPx7wTr9-fWJL8k6xomjHDd1XqgzoI-VkPP7NJ-sc,1536
|
|
26
|
+
mcp_people_local/http.py,sha256=G0mBgBaKAhBMUg4dqPIidBfg7MJpLUZCTrfPPNF8dtQ,2648
|
|
27
|
+
mcp_people_local/runtime.py,sha256=MmAYW_mdjaBbF5JHZcsymu1qPPXoBmQ15Xrss2W3mzI,5538
|
|
28
|
+
mcp_people_local/schema.py,sha256=iYTdXPpoaaU0GRe7llqFEkoZQ2p2pgVlO1jYRmpazus,3569
|
|
29
|
+
mcp_people_local/sqlite.py,sha256=aBYN57fYxAY6hWlIaA7fLLfyCrDt9fO1CbMs7ZxiB9w,3197
|
|
30
|
+
mcp_people_local/migrations/env.py,sha256=8Toh9_M8bCrGxk0dzMGqKdEzndeysb_ZEEvStAvXN-g,632
|
|
31
|
+
mcp_people_local/migrations/script.py.mako,sha256=tA1QlbzKAyTlUIF-F4q6mM8NXkVIAIDmIyf81YSlD10,616
|
|
32
|
+
mcp_people_local/migrations/versions/0001_baseline.py,sha256=8VnlQDCN--Ligz0ixW1sfDl_7NYDjcPfGZu5rPGtbqs,22081
|
|
33
|
+
mcp_people_local/migrations/versions/0002_deleted_at.py,sha256=EVAT8-pSqGqpDwOMxGHUOEmL3Z3Me06WeTEdGTCbgHU,3054
|
|
34
|
+
mcp_people_local/migrations/versions/0003_archived_at.py,sha256=KUxTqRVe0VU13gsrf2LhZaYRfjrBf0EJNfABltYQFgo,1508
|
|
35
|
+
mcp_people_local/migrations/versions/0004_retire_and_soft_delete_links.py,sha256=-Z6dUWs_qt-mLVrEYMW3gxdalphAa8MnNpUyPKXUmvE,2232
|
|
36
|
+
mcp_people/ui_dist/index.html,sha256=nTlQJshaZ4MF7HMjvhSuwb6MqkUg_mKFIcVZyyuX5Rs,735062
|
|
37
|
+
agentreadycrm-0.1.0.dist-info/METADATA,sha256=x_YXCXwdE2ehUV3t_YoMjVKAvkBVcjrF__kvbeCDm6k,6434
|
|
38
|
+
agentreadycrm-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
|
|
39
|
+
agentreadycrm-0.1.0.dist-info/entry_points.txt,sha256=KA_NkoNdGJPzJdCYhaIpCoudNWFGznBxCnKKPRCdTgo,134
|
|
40
|
+
agentreadycrm-0.1.0.dist-info/licenses/LICENSE,sha256=RTSjbg00L14JSy_hagMUQk7gs0-BolAfQKLBMDFF4XE,1074
|
|
41
|
+
agentreadycrm-0.1.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 NimbleBrain, Inc.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
mcp_people/SKILL.md
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: people
|
|
3
|
+
description: Working the CRM well beyond the server's rules - examples of resolving, importing, filtering and counting, external references, and what to do when a field is missing. Read when a task spans several records or a list.
|
|
4
|
+
metadata:
|
|
5
|
+
nimblebrain:
|
|
6
|
+
loading-strategy: dynamic
|
|
7
|
+
tool-affinity:
|
|
8
|
+
- find_or_create_contact
|
|
9
|
+
- find_or_create_organization
|
|
10
|
+
- import_contacts
|
|
11
|
+
- import_organizations
|
|
12
|
+
- resolve_external_refs
|
|
13
|
+
- list_contacts
|
|
14
|
+
- list_organizations
|
|
15
|
+
- count_records
|
|
16
|
+
- update_contact
|
|
17
|
+
- update_organization
|
|
18
|
+
- define_field
|
|
19
|
+
- merge_contacts
|
|
20
|
+
- merge_organizations
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
# Working the CRM
|
|
24
|
+
|
|
25
|
+
The server's instructions hold the rules (resolve before you write, field or dossier,
|
|
26
|
+
query rather than walk). This adds the patterns behind them.
|
|
27
|
+
|
|
28
|
+
## Bringing records in
|
|
29
|
+
|
|
30
|
+
- One person or company: `find_or_create_*` with everything you know in one call.
|
|
31
|
+
- A list: `import_contacts` / `import_organizations`, up to 500 rows a call. Rows that fail
|
|
32
|
+
come back under `skipped` with their index; fix those and import them again, since the
|
|
33
|
+
rest are saved and a repeat changes nothing.
|
|
34
|
+
- From another system: put its id for each record in `external_refs` as a URI
|
|
35
|
+
(`crm://companies/123`, or its record URL), never in a field. Before fetching from the
|
|
36
|
+
source, `resolve_external_refs` says which references are already here, so you fetch only
|
|
37
|
+
the missing ones.
|
|
38
|
+
|
|
39
|
+
## Filtering and counting
|
|
40
|
+
|
|
41
|
+
People at strong-fit companies with a live signal and a valid email:
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{"and": [
|
|
45
|
+
{"field": "organization.fit", "op": "eq", "value": "strong"},
|
|
46
|
+
{"field": "signals.active", "op": "gte", "value": 1},
|
|
47
|
+
{"field": "email_status", "op": "eq", "value": "valid"}
|
|
48
|
+
]}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
"How many strong-fit companies, by industry" is one `count_records(entity="organization",
|
|
52
|
+
field="industry", filter=...)`, not a walk. A refused filter names the paths, operators and
|
|
53
|
+
options that would have worked; use them rather than guessing again. Pass `columns` whenever
|
|
54
|
+
you read more than one page.
|
|
55
|
+
|
|
56
|
+
## When a field is missing
|
|
57
|
+
|
|
58
|
+
If the field you need is not in `list_fields` and you cannot define it, tell the user which
|
|
59
|
+
field is missing. Do not store the value in a dossier or another field meanwhile: it could
|
|
60
|
+
not be filtered, and the next agent would not find it.
|
|
61
|
+
|
|
62
|
+
## Showing a record
|
|
63
|
+
|
|
64
|
+
To show someone a contact, organization or deal, open the CRM at the record's `uri` (with
|
|
65
|
+
the host's open-app tool, where it has one) rather than describing where to click.
|
mcp_people/__init__.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""People MCP Server."""
|
mcp_people/addresses.py
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
"""The address of each record People holds that another tool may cite: a resource URI.
|
|
2
|
+
|
|
3
|
+
A contact, an organization, an opportunity, a signal and a proof point each have one, and
|
|
4
|
+
it is the same value everywhere it appears: the ``uri`` on every record a tool returns and
|
|
5
|
+
the resource this server serves at it. Another tool cites a People record by this address
|
|
6
|
+
and never by its id, because the address names the system that holds it and the id does
|
|
7
|
+
not. The first three are also the step the UI reports to the host as its location,
|
|
8
|
+
so the host can open the view showing them; a signal and a
|
|
9
|
+
proof point have no view, only the resource.
|
|
10
|
+
|
|
11
|
+
The kind is in the id's prefix (``ct_`` / ``org_`` / ``op_`` / ``sg_`` / ``pp_``,
|
|
12
|
+
:mod:`mcp_people.ids`), so the address is a pure function of the id. The UI parses the
|
|
13
|
+
three view shapes (``ui/src/App.tsx``); ``test_addresses.py`` pins them all on this side.
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
from __future__ import annotations
|
|
17
|
+
|
|
18
|
+
from mcp_people.ids import (
|
|
19
|
+
CONTACT_PREFIX,
|
|
20
|
+
OPPORTUNITY_PREFIX,
|
|
21
|
+
ORG_PREFIX,
|
|
22
|
+
PROOF_POINT_PREFIX,
|
|
23
|
+
SIGNAL_PREFIX,
|
|
24
|
+
)
|
|
25
|
+
|
|
26
|
+
CONTACT_URI_TEMPLATE = "people://contacts/{contact_id}"
|
|
27
|
+
ORGANIZATION_URI_TEMPLATE = "people://organizations/{organization_id}"
|
|
28
|
+
OPPORTUNITY_URI_TEMPLATE = "people://opportunities/{opportunity_id}"
|
|
29
|
+
SIGNAL_URI_TEMPLATE = "people://signals/{signal_id}"
|
|
30
|
+
PROOF_POINT_URI_TEMPLATE = "people://proof-points/{proof_point_id}"
|
|
31
|
+
|
|
32
|
+
_COLLECTION_BY_PREFIX = {
|
|
33
|
+
CONTACT_PREFIX: "contacts",
|
|
34
|
+
ORG_PREFIX: "organizations",
|
|
35
|
+
OPPORTUNITY_PREFIX: "opportunities",
|
|
36
|
+
SIGNAL_PREFIX: "signals",
|
|
37
|
+
PROOF_POINT_PREFIX: "proof-points",
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
def record_uri(record_id: str) -> str | None:
|
|
42
|
+
"""The address of the record ``record_id`` names.
|
|
43
|
+
|
|
44
|
+
``None`` for an id of a kind no other tool cites (an interaction, an edge).
|
|
45
|
+
"""
|
|
46
|
+
prefix, _, body = record_id.partition("_")
|
|
47
|
+
collection = _COLLECTION_BY_PREFIX.get(prefix)
|
|
48
|
+
return f"people://{collection}/{record_id}" if collection and body else None
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
"""People database layer.
|
|
2
|
+
|
|
3
|
+
Re-exports the SQLAlchemy ``metadata`` and table objects so callers (store,
|
|
4
|
+
migrations, tests) can ``from mcp_people.db import metadata, contact`` without
|
|
5
|
+
reaching into ``tables`` directly. Sessions come from the runtime
|
|
6
|
+
(:meth:`mcp_people.runtime.Runtime.session`), not from here.
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
from __future__ import annotations
|
|
10
|
+
|
|
11
|
+
from mcp_people.db.tables import (
|
|
12
|
+
contact,
|
|
13
|
+
interaction,
|
|
14
|
+
metadata,
|
|
15
|
+
opportunity,
|
|
16
|
+
organization,
|
|
17
|
+
people_audit,
|
|
18
|
+
uq_contact_email,
|
|
19
|
+
uq_org_domain,
|
|
20
|
+
)
|
|
21
|
+
|
|
22
|
+
__all__ = [
|
|
23
|
+
"metadata",
|
|
24
|
+
"organization",
|
|
25
|
+
"contact",
|
|
26
|
+
"interaction",
|
|
27
|
+
"opportunity",
|
|
28
|
+
"people_audit",
|
|
29
|
+
"uq_contact_email",
|
|
30
|
+
"uq_org_domain",
|
|
31
|
+
]
|