# How to work with Desync. Connect your AI assistant or your own systems to Desync's Catholic data. See what each dataset includes. From https://www.desync.ai/docs ## Getting access You need a Desync account and a plan. Sign up at crm.desync.ai, or book a call first. Then make a key in your account: one key works for both the MCP server and the REST API. | Option | Use it to | | --- | --- | | MCP server | Connect an AI assistant such as Claude or ChatGPT: every search, your history and saved lists. | | REST API | Connect your own systems: the searches, your history and your saved lists. | | Observatory | Read Catholic news, free. Bots and AI assistants need an Observatory API key, which comes with every plan. | ## Sign up and get help Questions about the API or MCP go to Jackson, one of our co-founders. He builds our data infrastructure. | Where | What for | | --- | --- | | [Sign up or sign in](https://crm.desync.ai/) | Your Desync account, in Desync Second Brain at crm.desync.ai. New accounts start here. | | [Book a time with Jackson](https://calendly.com/jackson-desync/) | A call about the API, MCP or connecting your own systems. | | [Email Jackson](mailto:jackson@desync.ai) | jackson@desync.ai | | [Use cases](https://www.desync.ai/use-cases) | Ten ways Desync can serve dioceses, parishes, schools, hospitals and all who serve them, each with three small steps for this week. | | [Write to us](https://www.desync.ai/contact) | Anything else, from plans to a dataset we do not hold. | ## Connect over MCP MCP is an open standard that lets AI assistants such as Claude and ChatGPT use outside tools. Add Desync to yours and it can search our data and keep saved lists. | Where | What for | | --- | --- | | [Install MCP](https://www.desync.ai/mcp) | One click adds Desync or Second Brain to Claude, Claude Code or Cursor. Then you sign in. | Desync Second Brain has its own MCP server for your records. Connect Claude, ChatGPT, Grok, Cursor or any other app that supports MCP to it from Settings, under MCP & APIs. Your AI assistant connects to https://mcp.desync.ai/mcp. Sign in with your Desync account, or send a key. MCP client config: ```json { "mcpServers": { "desync": { "type": "http", "url": "https://mcp.desync.ai/mcp", "headers": { "Authorization": "Bearer YOUR_DESYNC_API_KEY" } } } } ``` 1. In Claude or ChatGPT, add a custom connector named Desync. 2. Use https://mcp.desync.ai/mcp as its URL and leave the OAuth client fields blank. 3. Sign in with the Google account on your Desync account. A key goes in the Authorization header as a bearer token, or in an X-API-Key header. Without a key or a sign-in, the server answers 401 and asks your assistant to sign in. A sign-in lasts 30 days. ## MCP tools 13 tools in three groups. Searches count against your plan's monthly usage. History and saved lists are free. ### Search: 7 tools, read only | Tool | What it does | | --- | --- | | `church_search` | Parishes by name, place, diocese, language, school and more, with staff and contacts if asked. Up to 100 a call. | | `church_people_search` | Clergy and parish staff by name, place, role, title, or with an email or phone on record. Up to 200 a call. | | `church_sponsor_search` | Businesses that advertise in parish bulletins, by place and keyword. Up to 200 a call. | | `nd_search` | Notre Dame alumni by name. | | `nd_batch_search` | Many alumni lookups in one call: up to 10 queries, 100 rows in all. | | `nd_mass_match` | Alumni by any field: class, degree, college, hometown, title. Up to 100 a call. | | `nd_similar` | The graduates most like one you name, up to 100. | ### History: 1 tool | Tool | What it does | | --- | --- | | `lookup_history` | Records you already looked up, free to read again. | ### Saved lists: 5 tools | Tool | What it does | | --- | --- | | `list_custom_tables` | Your saved lists. | | `get_custom_table` | One list, with each entry's outreach status, notes and draft email. | | `create_custom_table` | Start a list of alumni, parish staff, school staff or sponsors, with or without an outreach pipeline. | | `add_to_custom_table` | Add records to a list. Duplicates are skipped. | | `update_custom_table_entry` | Set an entry's status, notes or draft email. | ## REST API JSON in and out: every call is a POST to https://mcp.desync.ai/api, with the same key. 50 rows by default, 200 at most. Errors come back as {"error": "..."} with status 400, 401 or 429. ### Endpoints | Endpoint | What it returns | | --- | --- | | `/church/search` | Parishes, with staff and contacts if you ask for them. | | `/church/people-search` | Clergy and parish staff. | | `/church/bulletins` | A parish's bulletins, with their events, programs and sponsors. | | `/nd/search` | Notre Dame alumni by any field. | | `/nd/similar` | The graduates most like one you name. | | `/history` | Records you already looked up. Free. | | `/custom-tables` | Your saved lists. Free. | | `/custom-tables/entries` | The entries in one list. Free. | Pastors in Illinois: ```shell curl -X POST https://mcp.desync.ai/api/church/people-search \ -H "Authorization: Bearer YOUR_DESYNC_API_KEY" \ -H "Content-Type: application/json" \ -d '{"filters": {"state": "IL", "clergy_category": "Pastor"}, "limit": 25}' ``` 50 requests a minute per address; past that, status 429. Schools and hospitals are searched in the Desync app, not yet through the API or MCP. ## Observatory Catholic news, read around the clock and linked to the people and places in it. Free to read. Bots and AI assistants reach its MCP server at https://api.observatory.desync.ai/mcp/ with an Observatory API key, which comes with every plan. Add it to Claude Code: ```shell claude mcp add --transport http desync-observatory \ https://api.observatory.desync.ai/mcp/ \ --header "X-API-Key: YOUR_OBSERVATORY_API_KEY" ``` ### 6 tools | Tool | What it does | | --- | --- | | `search_articles` | Stories by keyword and meaning, up to 25, with English titles and summaries. | | `get_article` | One story's English text. | | `list_entities` | People, organizations and places the news mentions. | | `entity_graph` | What one of them is linked to, two steps out at most. | | `list_sources` | Every source Observatory reads. | | `get_stats` | How much it has read. | ## What each dataset includes | Dataset | Fields | | --- | --- | | Parishes | Name, address, diocese, languages, year founded, website. Open one for Mass and confession times, sacraments, ministries, outreach, events, facilities, its school, and its bulletins. | | Parish staff and clergy | Name, role, title, email, phone, and the parish that lists them. | | Bulletin advertisers | Business, category, phone, email, address, website, and the parish bulletin it advertises in. | | Catholic schools | Type, grades, enrollment, class size, tuition, accreditation, staff. In the Desync app, not yet the API or MCP. | | School faculty and staff | Name, title, department, email, phone, profile, school. In the Desync app, not yet the API or MCP. | | Hospitals | Health system, type, trauma level, licensed beds, Catholic sponsor, departments. In the Desync app, not yet the API or MCP. | | Hospital clinicians and staff | Name, credentials, specialty, provider number, phone. In the Desync app, not yet the API or MCP. | | Notre Dame alumni | Name, class year, degree, major, college, honors, hometown, current title. | | Catholic news | Title, summary, link, source, date, language, tags, and the people, organizations and places in it. | ## When we last gathered it News comes in every day. We add to the other datasets in batches and date every count. Each one below says when we last gathered it. | Dataset | Last gathered | | --- | --- | | Parishes | Built in July 2026, added to through Oct 21, 2026. | | Dioceses | Leaders read once, Aug 12 to Sep 11, 2026. | | Catholic schools | Built in July 2026, added to on Sep 22 and Oct 16, 2026. | | Hospitals | Gathered once, in July 2026. | | Bulletin advertisers | Gathered once, from bulletins of spring 2026. | | Parish staff and clergy | Gathered July to August 2026. | | School faculty and staff | Gathered once, in July 2026. | | Hospital clinicians and staff | Gathered once, in July 2026. | | Notre Dame alumni | Gathered once, July to August 2026. | | Catholic news | Stories come in every day. Videos and podcasts were last added Oct 20, 2026. | We use public records and the data you bring. Nothing else. ## What is new We post what we launch and change on the Blog, newest first, and in an RSS feed at https://www.desync.ai/blog.xml. | Post | What it says | | --- | --- | | [Save people from LinkedIn in one click](https://www.desync.ai/blog/desync-extension-is-live) | Oct 20, 2026. Desync Extension saves a LinkedIn profile, company page or company website to Desync Second Brain, only when you choose. | | [fio audio ads, free for every paying customer](https://www.desync.ai/blog/free-audio-ads-on-fio) | Oct 13, 2026. fio is a Catholic audio platform with a Catholic-only audience. Every paying Desync customer can now run audio ads there for free, sent from Second Brain. | | [Desync Second Brain works with the tools you already use](https://www.desync.ai/blog/desync-crm-catholic-relationships-in-one-place) | Oct 9, 2026. Desync Second Brain sits on top of HubSpot, Salesforce, your mail and the apps your team uses. Connect your tools once, and its assistant works in them when you ask. | | [Desync Second Brain is live](https://www.desync.ai/blog/desync-crm-is-live) | Oct 8, 2026. Desync Second Brain is open at crm.desync.ai. Keep every person and organization in one place, with notes, tasks and files. |