# YouSpot > YouSpot is a personal CRM for AI-native professionals. It builds a second brain from the people, companies, notes and files you already deal with, syncing Gmail, Google Calendar, HubSpot, X and LinkedIn into one graph you can ask in plain English. YouSpot Free is $0 a month with no credit card, YouSpot Pro is $10 a month, and there are no seats to count. YouSpot Pro, 30 days free is $0 today at /pricing/freetrial. Card required. Then $10/month from day 31. Cancel before that and you pay nothing. --- # YouSpot: The AI-native Solo CRM built just for you. > YouSpot is a personal CRM for AI-native professionals. It builds a second brain from the people, companies, notes and files you already deal with, syncing Gmail, Google Calendar, HubSpot, X and LinkedIn into one graph you can ask in plain English. YouSpot Free is $0 a month with no credit card, YouSpot Pro is $10 a month, and there are no seats to count. YouSpot Pro, 30 days free is $0 today at /pricing/freetrial. Card required. Then $10/month from day 31. Cancel before that and you pay nothing. ## What YouSpot does ### Chat with your Second Brain Ask questions across a million objects (contacts, companies, notes and files) and get answers grounded in your own data, not the internet's. ### Connect what you already use HubSpot, Gmail, Google Calendar, X/Twitter and LinkedIn. Your tools finally talking to each other. ### Agents that keep working Long-running agents inspired by OpenClaw and Hermes, plus a premium GTM app library: ImageGen, ProspectFinder, DomainValue and more. ## When to use YouSpot - Look up a person or company in the signed-in member's own network, not the public web. - Answer "who do I know at X?" across imported LinkedIn connections, contacts and companies. - Log an interaction and set a follow-up after a call or an email. - Read what needs attention today: unanswered threads, stale follow-ups, upcoming meetings. - Send email from the member's YouSpot address, or read a connected Gmail mailbox and Google Calendar for context. - Sync a contact or company both ways with a connected HubSpot portal. - Search the member's Brain graph (notes, files, objects) and cite the objects behind the answer. ## Pricing Free to start. Pro is $10 a month. Cancel anytime. Details: https://youspot.com/pricing ## For developers and agents - [llms.txt](https://youspot.com/llms.txt): this site, for language models - [llms-full.txt](https://youspot.com/llms-full.txt): the long-form version - [sitemap.xml](https://youspot.com/sitemap.xml): every public page with a last-modified date - [index.md](https://youspot.com/index.md): the home page as markdown - [agents.md](https://youspot.com/agents.md): what an agent can do here, in one page - [MCP server](https://youspot.com/mcp/v1): streamable HTTP; initialize and tools/list need no credential - [MCP server card](https://youspot.com/.well-known/mcp/server-card.json): the endpoint, transport and every tool - [MCP manifest](https://youspot.com/.well-known/mcp.json): every MCP server on this domain, each with its own card - [auth.md](https://youspot.com/auth.md): how an agent gets a credential - [agent identity](https://youspot.com/agent/identity): what identity you can hold here, and who you are holding - [OpenAPI 3.1](https://youspot.com/openapi.json): every HTTP endpoint that exists - [Agent Plugins manifest](https://youspot.com/plugin.json): both MCP servers and the skills, in one bundle - [ChatGPT plugin manifest](https://youspot.com/.well-known/ai-plugin.json): the OpenAI manifest, naming the OpenAPI spec, the OAuth endpoints and the logo - [API catalog](https://youspot.com/.well-known/api-catalog): RFC 9727 - [agent index](https://youspot.com/v1): every endpoint, and what each one costs in credentials - [docs MCP server](https://youspot.com/mcp/docs): the public pages over MCP, no credential at all - [sandbox MCP server](https://youspot.com/mcp/sandbox): the read tools over a demo account, no credential and no signup - [sandbox](https://youspot.com/sandbox): the sandbox described: what is mounted under /sandbox, and whether the demo account is seeded - [ask](https://youspot.com/ask): a question in plain words, answered from these pages - [A2A agent card](https://youspot.com/.well-known/agent-card.json): JSON-RPC at /a2a - [OAuth 2.1 authorization server metadata](https://youspot.com/.well-known/oauth-authorization-server): RFC 8414 - [protected resource metadata](https://youspot.com/.well-known/oauth-protected-resource): RFC 9728 - [Agent Skills index](https://youspot.com/.well-known/agent-skills/index.json): skills an agent can load - [ARD catalog](https://youspot.com/.well-known/ard.json): agent resource discovery - [UCP business profile](https://youspot.com/.well-known/ucp): what an agent can transact with here, and what it cannot - [security.txt](https://youspot.com/.well-known/security.txt): how to report a vulnerability - [Web Bot Auth key directory](https://youspot.com/.well-known/http-message-signatures-directory): the key YouSpot agents sign their own requests with Docs: https://youspot.com/docs ## Questions ### What is YouSpot? A personal CRM for one person rather than a sales team. It imports the people and companies you already know, keeps them current from your mail, calendar and LinkedIn, and answers questions about them in plain English. ### How much does YouSpot cost? YouSpot Free is $0 a month and includes 50 credits/month, with no credit card: every account starts on it. YouSpot Pro is $10 a month and includes 1,000 credits/month, your pick of frontier models, room for 1,000,000 objects and three connected mailboxes. YouSpot Pro, 30 days free is $0 today and includes 1,000 credits/month. Then $10/month from day 31. Cancel before that and you pay nothing. Card required, one free trial per account, available at /pricing/freetrial. Cancel anytime. ### Can an AI agent use YouSpot? Yes. YouSpot runs a Model Context Protocol server at https://youspot.com/mcp with OAuth 2.1 (PKCE S256, dynamic client registration, refresh-token rotation), so Claude, ChatGPT, Cursor and Claude Code can connect to a member account and call its tools. ### What can the tools do? Search and read people, companies, notes and files in the member's graph; record interactions and follow-ups; read Gmail; read and edit Google Calendar events; send email from the member's YouSpot address; read LinkedIn network data; and sync with HubSpot. Listing tools is free. Product tool calls can spend member credits when MCP metering is enabled; writes ask first. ### What data does YouSpot hold? Only what a member connects: contacts, companies, notes, files, and the mail and calendar metadata from the mailboxes they link. Every tool call is scoped to the signed-in member. ### Which integrations are supported? HubSpot, Gmail, Google Calendar, X/Twitter and LinkedIn. ### How do I report a security issue? Email andrei@mail.youspot.com. The vulnerability disclosure policy is published at https://youspot.com/security, summarized at https://youspot.com/docs/security, and the machine-readable contact is https://youspot.com/.well-known/security.txt. ## Elsewhere - [Apps](https://youspot.com/tools) - [Second Brain](https://youspot.com/secondbrain) - [What is this?](https://youspot.com/about) - [Support](https://youspot.com/support), or email support@youspot.com - [Privacy](https://youspot.com/privacy), [Terms](https://youspot.com/terms) --- # YouSpot pricing > YouSpot Pro: $10/month. No seats to count, cancel anytime. All prices are in USD. Reviewed September 17, 2026. ## What it costs - **YouSpot Pro**: $10/month - Use up to 1,000 credits/month - Subscriptions renew monthly. No annual plan or per-seat charges. ## What is included - Build your own Second Brain - Chat using top frontier models like GPT, Claude and Gemini - Store up to 1M objects (contacts, companies, notes, files) - Connect to HubSpot, X/Twitter, LinkedIn and others - Deploy always-on agents inspired by OpenClaw - Access premium GTM apps including ImageGen, ProspectFinder, DomainValue and more ## The plans, side by side | | YouSpot Free | YouSpot Pro | | --- | --- | --- | | Price | $0/month | $10/month | | Billing | No credit card, nothing to cancel | Monthly, cancel anytime | | Credits | 50 credits/month | 1,000 credits/month | | Objects stored | 100,000 | 1,000,000 | | Connected mailboxes | 1 | 3 | | Models | Auto (picked for you) | Your pick of OpenAI, Anthropic and Gemini | | AI chat | Included | Included | | Additional credits | $1 per 100 credits | $1 per 100 credits | | Credit rollover | Plan credits expire; purchased credits do not | Plan credits expire; purchased credits do not | | Annual billing | Not offered | Not offered | | Free trial | Not offered | 30 days at $0, card required | | Data export | Included | Included | | Integrations | HubSpot, Gmail, Google Calendar, X, LinkedIn | HubSpot, Gmail, Google Calendar, X, LinkedIn | | Long-running agents | Yes | Yes | | GTM app library | Yes | Yes | | MCP server and HTTP API | Yes | Yes | | Seats | One person. There are no per-seat charges. | One person. There are no per-seat charges. | ## Plan tiers - **YouSpot Free**, $0/month: 50 credits/month, 100,000 objects, one connected mailbox. No credit card; every sign-up starts here. - **YouSpot Pro**, $10/month: 1,000 credits/month, 1,000,000 objects, three connected mailboxes, your pick of frontier models. For one person running agents across several accounts. ## Pro free trial - **YouSpot Pro, 30 days free**: $0 today. - Then $10/month from day 31. Cancel before that and you pay nothing. - A card is required at checkout. One free trial per account. - Includes 1,000 credits/month, 1,000,000 stored objects, three connected mailboxes, and all Pro features. - Start the trial at [YouSpot Pro, 30 days free](https://youspot.com/pricing/freetrial). - YouSpot Free is separate from this Pro trial: no card required and no trial period. ## Additional credit packs | Purchase | Price (USD) | Credits | Expiration | | --- | --- | --- | --- | | 1 pack | $1 one-time | 100 | None | | 10 packs | $10 one-time | 1,000 | None | | 50 packs (maximum per purchase) | $50 one-time | 5,000 | None | - Credit packs add usage credits, not stored-object capacity or connected mailboxes. - Buy packs from billing settings. Automatic top-up is optional. - Plan credits are used before purchased credits. Purchased credit packs do not expire. ## Cost examples - YouSpot Free with 50 credits used in a billing period: $0 subscription, no credit pack needed. - YouSpot Free with 150 credits used in a billing period: $0 subscription plus one $1 credit pack, $1 total. - YouSpot Pro with 1,200 credits used in a billing period: $10 subscription plus two $1 credit packs, $12 total. - Examples assume the regular monthly allowance, no promotional discount, no previously purchased credit balance, and automatic top-up turned off. Paid examples exclude the free trial. ## What a credit is A credit is one unit of metered work: - A billable chat message costs 1 credit. A failed reply, or a turn in which every attempted tool fails, is not billed. - A successful metered app run costs 1 credit. A failed run is not billed. - When MCP metering is enabled for a member, a successful tool call that starts a new question group costs 1 credit. Later calls within that group are not charged again. A pause or the group action limit starts a new group. - MCP question groups can include read tools. Charging does not depend on whether a tool reaches a model. Browsing your stored data in the app is free. The documentation MCP server, sandbox, public directory, discovery documents, and product MCP initialize and tools/list requests do not spend member credits. Plan credits reset each billing period and do not roll over. Purchased credit packs do not expire. If your balance runs out, add credits or wait for the next plan allowance; automatic top-up can buy more credits when enabled. Your stored data is not deleted. ## Limits - Objects (contacts, companies, notes, files): 100,000 on YouSpot Free, 1,000,000 on YouSpot Pro. - Connected mailboxes: 1 on YouSpot Free, 3 on YouSpot Pro. - Credits: 50 credits/month on YouSpot Free, 1,000 credits/month on YouSpot Pro. - Models: YouSpot Free runs on Auto, a model picked for you. YouSpot Pro adds your pick of OpenAI, Anthropic and Gemini models. - Seats: one person on every plan. There is no team plan and no per-seat charge. - Anonymous API and MCP calls are rate limited per address; the headers that declare the budget are documented at [/docs/versioning](https://youspot.com/docs/versioning). ## For agents and developers - The MCP server, the HTTP API and the OAuth server are included in both plans at no extra cost. There is no separate API tier and no per-call charge beyond credits. - No credential is needed to read the [documentation MCP server](https://youspot.com/mcp/docs), the [sandbox](https://youspot.com/sandbox), the public directory, or any discovery document. Those are free to anyone, with no account. - Product MCP tool calls require member authorization. When metering is enabled for that member, calls spend credits by question group, including groups that only read data. - Rate limits and the headers that declare them are documented at [/docs/versioning](https://youspot.com/docs/versioning). - YouSpot Free is the self-serve $0 plan every new account starts on, with 50 credits/month and no trial period. The [30-day Pro trial](https://youspot.com/pricing/freetrial) requires a card and renews at $10/month unless cancelled. There is no annual discount. ## Billing - Billed monthly in US dollars. - Change plans from billing settings. An upgrade to YouSpot Pro is immediate; cancelling takes effect at the end of the current period and returns the account to YouSpot Free. - Cancel any time from billing settings. There is no contract and no cancellation fee. - Your data stays readable and exportable after cancelling. ## Questions ### Which plan should I pick? YouSpot Free at $0 if you ask a few questions a day and connect one mailbox: no credit card, and every account starts there. YouSpot Pro at $10 a month if you want your pick of frontier models, more than 50 credits/month, several mailboxes in sync, or more than 100,000 objects. ### Is there a free plan? Yes. YouSpot Free is $0 a month with 50 credits/month, 100,000 objects and one connected mailbox. No credit card: sign up at https://youspot.com/pricing and you are on it. ### Is there a trial? YouSpot Pro, 30 days free: $0 today, with 1,000 credits/month and Pro features. Then $10/month from day 31. Cancel before that and you pay nothing. Card required, one free trial per account. Start at https://youspot.com/pricing/freetrial. There is no annual discount. ### What happens when I run out of credits? Metered work stops until you add credits or your plan allowance resets. Automatic top-up can buy more credits when enabled. Your stored data is not deleted, and you can still browse it in the app. ### Can I change plans? Yes, from billing settings. Moving up to YouSpot Pro takes effect immediately. Cancelling YouSpot Pro takes effect when the current period ends, so nothing already paid for is lost, and the account returns to YouSpot Free. ### Do agents pay per call? There is no separate API subscription. When MCP metering is enabled for a member, related tool calls are grouped into questions rather than charged individually. A successful tool call that starts a new group costs 1 credit; later calls in that group are not charged again. This can include read tools and does not depend on whether a call reaches a model. ### What costs nothing? Browsing your stored data in the app, the documentation MCP server, the sandbox, the public directory and profiles, discovery documents, and product MCP initialize and tools/list requests. Product MCP read tools can spend credits when member metering is enabled. ### How do I cancel? From billing settings, any time. There is no contract and no cancellation fee. Your data stays readable and exportable after cancelling. ## The plans - [YouSpot Free](https://youspot.com/pricing): $0 a month, 50 credits/month - [YouSpot Pro](https://youspot.com/pricing/pro): $10 a month, 1,000 credits/month ## More - [Pricing page](https://youspot.com/pricing) - [Docs for developers and agents](https://youspot.com/docs) - [Support](https://youspot.com/support), or email support@youspot.com --- # YouSpot pricing > YouSpot Pro: $10/month. No seats to count, cancel anytime. All prices are in USD. Reviewed September 17, 2026. ## What it costs - **YouSpot Pro**: $10/month - Use up to 1,000 credits/month - Subscriptions renew monthly. No annual plan or per-seat charges. ## What is included - Build your own Second Brain - Chat using top frontier models like GPT, Claude and Gemini - Store up to 1M objects (contacts, companies, notes, files) - Connect to HubSpot, X/Twitter, LinkedIn and others - Deploy always-on agents inspired by OpenClaw - Access premium GTM apps including ImageGen, ProspectFinder, DomainValue and more ## The plans, side by side | | YouSpot Free | YouSpot Pro | | --- | --- | --- | | Price | $0/month | $10/month | | Billing | No credit card, nothing to cancel | Monthly, cancel anytime | | Credits | 50 credits/month | 1,000 credits/month | | Objects stored | 100,000 | 1,000,000 | | Connected mailboxes | 1 | 3 | | Models | Auto (picked for you) | Your pick of OpenAI, Anthropic and Gemini | | AI chat | Included | Included | | Additional credits | $1 per 100 credits | $1 per 100 credits | | Credit rollover | Plan credits expire; purchased credits do not | Plan credits expire; purchased credits do not | | Annual billing | Not offered | Not offered | | Free trial | Not offered | 30 days at $0, card required | | Data export | Included | Included | | Integrations | HubSpot, Gmail, Google Calendar, X, LinkedIn | HubSpot, Gmail, Google Calendar, X, LinkedIn | | Long-running agents | Yes | Yes | | GTM app library | Yes | Yes | | MCP server and HTTP API | Yes | Yes | | Seats | One person. There are no per-seat charges. | One person. There are no per-seat charges. | ## Plan tiers - **YouSpot Free**, $0/month: 50 credits/month, 100,000 objects, one connected mailbox. No credit card; every sign-up starts here. - **YouSpot Pro**, $10/month: 1,000 credits/month, 1,000,000 objects, three connected mailboxes, your pick of frontier models. For one person running agents across several accounts. ## Pro free trial - **YouSpot Pro, 30 days free**: $0 today. - Then $10/month from day 31. Cancel before that and you pay nothing. - A card is required at checkout. One free trial per account. - Includes 1,000 credits/month, 1,000,000 stored objects, three connected mailboxes, and all Pro features. - Start the trial at [YouSpot Pro, 30 days free](https://youspot.com/pricing/freetrial). - YouSpot Free is separate from this Pro trial: no card required and no trial period. ## Additional credit packs | Purchase | Price (USD) | Credits | Expiration | | --- | --- | --- | --- | | 1 pack | $1 one-time | 100 | None | | 10 packs | $10 one-time | 1,000 | None | | 50 packs (maximum per purchase) | $50 one-time | 5,000 | None | - Credit packs add usage credits, not stored-object capacity or connected mailboxes. - Buy packs from billing settings. Automatic top-up is optional. - Plan credits are used before purchased credits. Purchased credit packs do not expire. ## Cost examples - YouSpot Free with 50 credits used in a billing period: $0 subscription, no credit pack needed. - YouSpot Free with 150 credits used in a billing period: $0 subscription plus one $1 credit pack, $1 total. - YouSpot Pro with 1,200 credits used in a billing period: $10 subscription plus two $1 credit packs, $12 total. - Examples assume the regular monthly allowance, no promotional discount, no previously purchased credit balance, and automatic top-up turned off. Paid examples exclude the free trial. ## What a credit is A credit is one unit of metered work: - A billable chat message costs 1 credit. A failed reply, or a turn in which every attempted tool fails, is not billed. - A successful metered app run costs 1 credit. A failed run is not billed. - When MCP metering is enabled for a member, a successful tool call that starts a new question group costs 1 credit. Later calls within that group are not charged again. A pause or the group action limit starts a new group. - MCP question groups can include read tools. Charging does not depend on whether a tool reaches a model. Browsing your stored data in the app is free. The documentation MCP server, sandbox, public directory, discovery documents, and product MCP initialize and tools/list requests do not spend member credits. Plan credits reset each billing period and do not roll over. Purchased credit packs do not expire. If your balance runs out, add credits or wait for the next plan allowance; automatic top-up can buy more credits when enabled. Your stored data is not deleted. ## Limits - Objects (contacts, companies, notes, files): 100,000 on YouSpot Free, 1,000,000 on YouSpot Pro. - Connected mailboxes: 1 on YouSpot Free, 3 on YouSpot Pro. - Credits: 50 credits/month on YouSpot Free, 1,000 credits/month on YouSpot Pro. - Models: YouSpot Free runs on Auto, a model picked for you. YouSpot Pro adds your pick of OpenAI, Anthropic and Gemini models. - Seats: one person on every plan. There is no team plan and no per-seat charge. - Anonymous API and MCP calls are rate limited per address; the headers that declare the budget are documented at [/docs/versioning](https://youspot.com/docs/versioning). ## For agents and developers - The MCP server, the HTTP API and the OAuth server are included in both plans at no extra cost. There is no separate API tier and no per-call charge beyond credits. - No credential is needed to read the [documentation MCP server](https://youspot.com/mcp/docs), the [sandbox](https://youspot.com/sandbox), the public directory, or any discovery document. Those are free to anyone, with no account. - Product MCP tool calls require member authorization. When metering is enabled for that member, calls spend credits by question group, including groups that only read data. - Rate limits and the headers that declare them are documented at [/docs/versioning](https://youspot.com/docs/versioning). - YouSpot Free is the self-serve $0 plan every new account starts on, with 50 credits/month and no trial period. The [30-day Pro trial](https://youspot.com/pricing/freetrial) requires a card and renews at $10/month unless cancelled. There is no annual discount. ## Billing - Billed monthly in US dollars. - Change plans from billing settings. An upgrade to YouSpot Pro is immediate; cancelling takes effect at the end of the current period and returns the account to YouSpot Free. - Cancel any time from billing settings. There is no contract and no cancellation fee. - Your data stays readable and exportable after cancelling. ## Questions ### Which plan should I pick? YouSpot Free at $0 if you ask a few questions a day and connect one mailbox: no credit card, and every account starts there. YouSpot Pro at $10 a month if you want your pick of frontier models, more than 50 credits/month, several mailboxes in sync, or more than 100,000 objects. ### Is there a free plan? Yes. YouSpot Free is $0 a month with 50 credits/month, 100,000 objects and one connected mailbox. No credit card: sign up at https://youspot.com/pricing and you are on it. ### Is there a trial? YouSpot Pro, 30 days free: $0 today, with 1,000 credits/month and Pro features. Then $10/month from day 31. Cancel before that and you pay nothing. Card required, one free trial per account. Start at https://youspot.com/pricing/freetrial. There is no annual discount. ### What happens when I run out of credits? Metered work stops until you add credits or your plan allowance resets. Automatic top-up can buy more credits when enabled. Your stored data is not deleted, and you can still browse it in the app. ### Can I change plans? Yes, from billing settings. Moving up to YouSpot Pro takes effect immediately. Cancelling YouSpot Pro takes effect when the current period ends, so nothing already paid for is lost, and the account returns to YouSpot Free. ### Do agents pay per call? There is no separate API subscription. When MCP metering is enabled for a member, related tool calls are grouped into questions rather than charged individually. A successful tool call that starts a new group costs 1 credit; later calls in that group are not charged again. This can include read tools and does not depend on whether a call reaches a model. ### What costs nothing? Browsing your stored data in the app, the documentation MCP server, the sandbox, the public directory and profiles, discovery documents, and product MCP initialize and tools/list requests. Product MCP read tools can spend credits when member metering is enabled. ### How do I cancel? From billing settings, any time. There is no contract and no cancellation fee. Your data stays readable and exportable after cancelling. ## The plans - [YouSpot Free](https://youspot.com/pricing): $0 a month, 50 credits/month - [YouSpot Pro](https://youspot.com/pricing/pro): $10 a month, 1,000 credits/month ## More - [Pricing page](https://youspot.com/pricing) - [Docs for developers and agents](https://youspot.com/docs) - [Support](https://youspot.com/support), or email support@youspot.com --- # YouSpot Pro free trial pricing > YouSpot Pro, 30 days free: $0 today. No seats to count, cancel anytime. Then $10/month from day 31. Cancel before that and you pay nothing. All prices are in USD. Reviewed September 17, 2026. ## What it costs - **YouSpot Pro, 30 days free**: $0 today - Use up to 1,000 credits/month - Subscriptions renew monthly. No annual plan or per-seat charges. ## What is included - Build your own Second Brain - Chat using top frontier models like GPT, Claude and Gemini - Store up to 1M objects (contacts, companies, notes, files) - Connect to HubSpot, X/Twitter, LinkedIn and others - Deploy always-on agents inspired by OpenClaw - Access premium GTM apps including ImageGen, ProspectFinder, DomainValue and more ## The plans, side by side | | YouSpot Free | YouSpot Pro | | --- | --- | --- | | Price | $0/month | $10/month | | Billing | No credit card, nothing to cancel | Monthly, cancel anytime | | Credits | 50 credits/month | 1,000 credits/month | | Objects stored | 100,000 | 1,000,000 | | Connected mailboxes | 1 | 3 | | Models | Auto (picked for you) | Your pick of OpenAI, Anthropic and Gemini | | AI chat | Included | Included | | Additional credits | $1 per 100 credits | $1 per 100 credits | | Credit rollover | Plan credits expire; purchased credits do not | Plan credits expire; purchased credits do not | | Annual billing | Not offered | Not offered | | Free trial | Not offered | 30 days at $0, card required | | Data export | Included | Included | | Integrations | HubSpot, Gmail, Google Calendar, X, LinkedIn | HubSpot, Gmail, Google Calendar, X, LinkedIn | | Long-running agents | Yes | Yes | | GTM app library | Yes | Yes | | MCP server and HTTP API | Yes | Yes | | Seats | One person. There are no per-seat charges. | One person. There are no per-seat charges. | ## Plan tiers - **YouSpot Free**, $0/month: 50 credits/month, 100,000 objects, one connected mailbox. No credit card; every sign-up starts here. - **YouSpot Pro**, $10/month: 1,000 credits/month, 1,000,000 objects, three connected mailboxes, your pick of frontier models. For one person running agents across several accounts. ## Pro free trial - **YouSpot Pro, 30 days free**: $0 today. - Then $10/month from day 31. Cancel before that and you pay nothing. - A card is required at checkout. One free trial per account. - Includes 1,000 credits/month, 1,000,000 stored objects, three connected mailboxes, and all Pro features. - Start the trial at [YouSpot Pro, 30 days free](https://youspot.com/pricing/freetrial). - YouSpot Free is separate from this Pro trial: no card required and no trial period. ## Additional credit packs | Purchase | Price (USD) | Credits | Expiration | | --- | --- | --- | --- | | 1 pack | $1 one-time | 100 | None | | 10 packs | $10 one-time | 1,000 | None | | 50 packs (maximum per purchase) | $50 one-time | 5,000 | None | - Credit packs add usage credits, not stored-object capacity or connected mailboxes. - Buy packs from billing settings. Automatic top-up is optional. - Plan credits are used before purchased credits. Purchased credit packs do not expire. ## Cost examples - YouSpot Free with 50 credits used in a billing period: $0 subscription, no credit pack needed. - YouSpot Free with 150 credits used in a billing period: $0 subscription plus one $1 credit pack, $1 total. - YouSpot Pro with 1,200 credits used in a billing period: $10 subscription plus two $1 credit packs, $12 total. - Examples assume the regular monthly allowance, no promotional discount, no previously purchased credit balance, and automatic top-up turned off. Paid examples exclude the free trial. ## What a credit is A credit is one unit of metered work: - A billable chat message costs 1 credit. A failed reply, or a turn in which every attempted tool fails, is not billed. - A successful metered app run costs 1 credit. A failed run is not billed. - When MCP metering is enabled for a member, a successful tool call that starts a new question group costs 1 credit. Later calls within that group are not charged again. A pause or the group action limit starts a new group. - MCP question groups can include read tools. Charging does not depend on whether a tool reaches a model. Browsing your stored data in the app is free. The documentation MCP server, sandbox, public directory, discovery documents, and product MCP initialize and tools/list requests do not spend member credits. Plan credits reset each billing period and do not roll over. Purchased credit packs do not expire. If your balance runs out, add credits or wait for the next plan allowance; automatic top-up can buy more credits when enabled. Your stored data is not deleted. ## Limits - Objects (contacts, companies, notes, files): 100,000 on YouSpot Free, 1,000,000 on YouSpot Pro. - Connected mailboxes: 1 on YouSpot Free, 3 on YouSpot Pro. - Credits: 50 credits/month on YouSpot Free, 1,000 credits/month on YouSpot Pro. - Models: YouSpot Free runs on Auto, a model picked for you. YouSpot Pro adds your pick of OpenAI, Anthropic and Gemini models. - Seats: one person on every plan. There is no team plan and no per-seat charge. - Anonymous API and MCP calls are rate limited per address; the headers that declare the budget are documented at [/docs/versioning](https://youspot.com/docs/versioning). ## For agents and developers - The MCP server, the HTTP API and the OAuth server are included in both plans at no extra cost. There is no separate API tier and no per-call charge beyond credits. - No credential is needed to read the [documentation MCP server](https://youspot.com/mcp/docs), the [sandbox](https://youspot.com/sandbox), the public directory, or any discovery document. Those are free to anyone, with no account. - Product MCP tool calls require member authorization. When metering is enabled for that member, calls spend credits by question group, including groups that only read data. - Rate limits and the headers that declare them are documented at [/docs/versioning](https://youspot.com/docs/versioning). - YouSpot Free is the self-serve $0 plan every new account starts on, with 50 credits/month and no trial period. The [30-day Pro trial](https://youspot.com/pricing/freetrial) requires a card and renews at $10/month unless cancelled. There is no annual discount. ## Billing - Billed monthly in US dollars. - Change plans from billing settings. An upgrade to YouSpot Pro is immediate; cancelling takes effect at the end of the current period and returns the account to YouSpot Free. - Cancel any time from billing settings. There is no contract and no cancellation fee. - Your data stays readable and exportable after cancelling. ## Questions ### Which plan should I pick? YouSpot Free at $0 if you ask a few questions a day and connect one mailbox: no credit card, and every account starts there. YouSpot Pro at $10 a month if you want your pick of frontier models, more than 50 credits/month, several mailboxes in sync, or more than 100,000 objects. ### Is there a free plan? Yes. YouSpot Free is $0 a month with 50 credits/month, 100,000 objects and one connected mailbox. No credit card: sign up at https://youspot.com/pricing and you are on it. ### Is there a trial? YouSpot Pro, 30 days free: $0 today, with 1,000 credits/month and Pro features. Then $10/month from day 31. Cancel before that and you pay nothing. Card required, one free trial per account. Start at https://youspot.com/pricing/freetrial. There is no annual discount. ### What happens when I run out of credits? Metered work stops until you add credits or your plan allowance resets. Automatic top-up can buy more credits when enabled. Your stored data is not deleted, and you can still browse it in the app. ### Can I change plans? Yes, from billing settings. Moving up to YouSpot Pro takes effect immediately. Cancelling YouSpot Pro takes effect when the current period ends, so nothing already paid for is lost, and the account returns to YouSpot Free. ### Do agents pay per call? There is no separate API subscription. When MCP metering is enabled for a member, related tool calls are grouped into questions rather than charged individually. A successful tool call that starts a new group costs 1 credit; later calls in that group are not charged again. This can include read tools and does not depend on whether a call reaches a model. ### What costs nothing? Browsing your stored data in the app, the documentation MCP server, the sandbox, the public directory and profiles, discovery documents, and product MCP initialize and tools/list requests. Product MCP read tools can spend credits when member metering is enabled. ### How do I cancel? From billing settings, any time. There is no contract and no cancellation fee. Your data stays readable and exportable after cancelling. ## The plans - [YouSpot Free](https://youspot.com/pricing): $0 a month, 50 credits/month - [YouSpot Pro](https://youspot.com/pricing/pro): $10 a month, 1,000 credits/month ## More - [Pricing page](https://youspot.com/pricing) - [Docs for developers and agents](https://youspot.com/docs) - [Support](https://youspot.com/support), or email support@youspot.com --- # YouSpot Solo pricing > YouSpot Solo: $1/month. No seats to count, cancel anytime. This is a legacy, unlisted plan for existing members. New accounts start on Free and can upgrade to Pro. All prices are in USD. Reviewed September 17, 2026. ## What it costs - **YouSpot Solo**: $1/month - Use up to 100 credits/month - Subscriptions renew monthly. No annual plan or per-seat charges. ## What is included - Chat with your Second Brain - Access to OpenAI, Anthropic and Gemini models - Store up to 100k objects (contacts, companies, notes, files) - 1 connected mailbox - Support for HubSpot, GMail, GCal, X/Twitter and LinkedIn - Long-running agents inspired by OpenClaw/Hermes - Access to premium GTM app library including ImageGen, ProspectFinder, DomainValue and others ## The plans, side by side | | YouSpot Free | YouSpot Pro | | --- | --- | --- | | Price | $0/month | $10/month | | Billing | No credit card, nothing to cancel | Monthly, cancel anytime | | Credits | 50 credits/month | 1,000 credits/month | | Objects stored | 100,000 | 1,000,000 | | Connected mailboxes | 1 | 3 | | Models | Auto (picked for you) | Your pick of OpenAI, Anthropic and Gemini | | AI chat | Included | Included | | Additional credits | $1 per 100 credits | $1 per 100 credits | | Credit rollover | Plan credits expire; purchased credits do not | Plan credits expire; purchased credits do not | | Annual billing | Not offered | Not offered | | Free trial | Not offered | 30 days at $0, card required | | Data export | Included | Included | | Integrations | HubSpot, Gmail, Google Calendar, X, LinkedIn | HubSpot, Gmail, Google Calendar, X, LinkedIn | | Long-running agents | Yes | Yes | | GTM app library | Yes | Yes | | MCP server and HTTP API | Yes | Yes | | Seats | One person. There are no per-seat charges. | One person. There are no per-seat charges. | ## Plan tiers - **YouSpot Free**, $0/month: 50 credits/month, 100,000 objects, one connected mailbox. No credit card; every sign-up starts here. - **YouSpot Pro**, $10/month: 1,000 credits/month, 1,000,000 objects, three connected mailboxes, your pick of frontier models. For one person running agents across several accounts. ## Pro free trial - **YouSpot Pro, 30 days free**: $0 today. - Then $10/month from day 31. Cancel before that and you pay nothing. - A card is required at checkout. One free trial per account. - Includes 1,000 credits/month, 1,000,000 stored objects, three connected mailboxes, and all Pro features. - Start the trial at [YouSpot Pro, 30 days free](https://youspot.com/pricing/freetrial). - YouSpot Free is separate from this Pro trial: no card required and no trial period. ## Additional credit packs | Purchase | Price (USD) | Credits | Expiration | | --- | --- | --- | --- | | 1 pack | $1 one-time | 100 | None | | 10 packs | $10 one-time | 1,000 | None | | 50 packs (maximum per purchase) | $50 one-time | 5,000 | None | - Credit packs add usage credits, not stored-object capacity or connected mailboxes. - Buy packs from billing settings. Automatic top-up is optional. - Plan credits are used before purchased credits. Purchased credit packs do not expire. ## Cost examples - YouSpot Free with 50 credits used in a billing period: $0 subscription, no credit pack needed. - YouSpot Free with 150 credits used in a billing period: $0 subscription plus one $1 credit pack, $1 total. - YouSpot Pro with 1,200 credits used in a billing period: $10 subscription plus two $1 credit packs, $12 total. - Examples assume the regular monthly allowance, no promotional discount, no previously purchased credit balance, and automatic top-up turned off. Paid examples exclude the free trial. ## What a credit is A credit is one unit of metered work: - A billable chat message costs 1 credit. A failed reply, or a turn in which every attempted tool fails, is not billed. - A successful metered app run costs 1 credit. A failed run is not billed. - When MCP metering is enabled for a member, a successful tool call that starts a new question group costs 1 credit. Later calls within that group are not charged again. A pause or the group action limit starts a new group. - MCP question groups can include read tools. Charging does not depend on whether a tool reaches a model. Browsing your stored data in the app is free. The documentation MCP server, sandbox, public directory, discovery documents, and product MCP initialize and tools/list requests do not spend member credits. Plan credits reset each billing period and do not roll over. Purchased credit packs do not expire. If your balance runs out, add credits or wait for the next plan allowance; automatic top-up can buy more credits when enabled. Your stored data is not deleted. ## Limits - Objects (contacts, companies, notes, files): 100,000 on YouSpot Free, 1,000,000 on YouSpot Pro. - Connected mailboxes: 1 on YouSpot Free, 3 on YouSpot Pro. - Credits: 50 credits/month on YouSpot Free, 1,000 credits/month on YouSpot Pro. - Models: YouSpot Free runs on Auto, a model picked for you. YouSpot Pro adds your pick of OpenAI, Anthropic and Gemini models. - Seats: one person on every plan. There is no team plan and no per-seat charge. - Anonymous API and MCP calls are rate limited per address; the headers that declare the budget are documented at [/docs/versioning](https://youspot.com/docs/versioning). ## For agents and developers - The MCP server, the HTTP API and the OAuth server are included in both plans at no extra cost. There is no separate API tier and no per-call charge beyond credits. - No credential is needed to read the [documentation MCP server](https://youspot.com/mcp/docs), the [sandbox](https://youspot.com/sandbox), the public directory, or any discovery document. Those are free to anyone, with no account. - Product MCP tool calls require member authorization. When metering is enabled for that member, calls spend credits by question group, including groups that only read data. - Rate limits and the headers that declare them are documented at [/docs/versioning](https://youspot.com/docs/versioning). - YouSpot Free is the self-serve $0 plan every new account starts on, with 50 credits/month and no trial period. The [30-day Pro trial](https://youspot.com/pricing/freetrial) requires a card and renews at $10/month unless cancelled. There is no annual discount. ## Billing - Billed monthly in US dollars. - Change plans from billing settings. An upgrade to YouSpot Pro is immediate; cancelling takes effect at the end of the current period and returns the account to YouSpot Free. - Cancel any time from billing settings. There is no contract and no cancellation fee. - Your data stays readable and exportable after cancelling. ## Questions ### Which plan should I pick? YouSpot Free at $0 if you ask a few questions a day and connect one mailbox: no credit card, and every account starts there. YouSpot Pro at $10 a month if you want your pick of frontier models, more than 50 credits/month, several mailboxes in sync, or more than 100,000 objects. ### Is there a free plan? Yes. YouSpot Free is $0 a month with 50 credits/month, 100,000 objects and one connected mailbox. No credit card: sign up at https://youspot.com/pricing and you are on it. ### Is there a trial? YouSpot Pro, 30 days free: $0 today, with 1,000 credits/month and Pro features. Then $10/month from day 31. Cancel before that and you pay nothing. Card required, one free trial per account. Start at https://youspot.com/pricing/freetrial. There is no annual discount. ### What happens when I run out of credits? Metered work stops until you add credits or your plan allowance resets. Automatic top-up can buy more credits when enabled. Your stored data is not deleted, and you can still browse it in the app. ### Can I change plans? Yes, from billing settings. Moving up to YouSpot Pro takes effect immediately. Cancelling YouSpot Pro takes effect when the current period ends, so nothing already paid for is lost, and the account returns to YouSpot Free. ### Do agents pay per call? There is no separate API subscription. When MCP metering is enabled for a member, related tool calls are grouped into questions rather than charged individually. A successful tool call that starts a new group costs 1 credit; later calls in that group are not charged again. This can include read tools and does not depend on whether a call reaches a model. ### What costs nothing? Browsing your stored data in the app, the documentation MCP server, the sandbox, the public directory and profiles, discovery documents, and product MCP initialize and tools/list requests. Product MCP read tools can spend credits when member metering is enabled. ### How do I cancel? From billing settings, any time. There is no contract and no cancellation fee. Your data stays readable and exportable after cancelling. ## The plans - [YouSpot Free](https://youspot.com/pricing): $0 a month, 50 credits/month - [YouSpot Pro](https://youspot.com/pricing/pro): $10 a month, 1,000 credits/month ## More - [Pricing page](https://youspot.com/pricing) - [Docs for developers and agents](https://youspot.com/docs) - [Support](https://youspot.com/support), or email support@youspot.com --- # The Second Brain: you forget, it does not > Everything you know, every person, conversation, deal, domain and half-finished thought, filed into one graph, connected the way it actually happened, and answerable in plain English. ## It fills itself Zero data entry. That is the whole point. Connect Gmail, LinkedIn, HubSpot or the Chrome extension once, and the people you email, the posts you write and the files you save land in the graph on their own: typed, tagged and time-stamped. ## You just ask Plain English in, your own life out. "Who do I know at Gusto?" "Which invitations did I never answer?" "What did I pay for that domain?" It answers from your graph, not the internet's. ## It acts while you sleep Agents that wake when life happens. New email arrives, an agent reads it, files what matters, and leaves a paper trail in your feed. Your Second Brain does not just remember, it does the follow-up. ## Getting one The Second Brain comes with every YouSpot plan. See [pricing](https://youspot.com/pricing). An agent can read and write the same graph over MCP. See the [docs](https://youspot.com/docs). --- # YouSpot apps > Sharp, focused apps for the daily work of revenue: grade your stack, make your assets, price your names. Each one does one job well. ## The apps ### [HubGrader](https://youspot.com/hubgrader) Grade any HubSpot portal and see how your setup stacks up against best practices. ### [CompanyResearch](https://youspot.com/companyresearch) AI research reports on any company: people, products, funding and news. ### [ImageGen](https://youspot.com/imagegen) Generate and edit on-brand images with AI, right in your browser. ### [GHero](https://youspot.com/ghero) Search your Gmail in plain English and see the matching emails. ### [DomainValue](https://youspot.com/domainvalue) AI-powered domain valuations to price and compare any name in seconds. ### [DomainSuggest](https://youspot.com/domainsuggest) AI-powered domain name suggestions for your next idea. ### [MetaPrompt](https://youspot.com/metaprompt) Paste any AI prompt and get a sharper, more effective version back. ### [LinkedIn Explorer](https://youspot.com/linkedin/explorer) Import your LinkedIn network and ask questions across your connections. ## More - [Pricing](https://youspot.com/pricing): every app is included in the plan - [Docs for developers and agents](https://youspot.com/docs) --- # YouSpot docs for developers and agents > The MCP server, OAuth 2.1, the HTTP endpoints, and the discovery files that describe them. ## Pages - [YouSpot for developers and agents](https://youspot.com/docs/overview.md): What YouSpot exposes to code: an MCP server, OAuth 2.1, public profile endpoints, and the discovery files that describe them. - [YouSpot API authentication](https://youspot.com/docs/authentication.md): YouSpot is an OAuth 2.1 authorization server for agents: dynamic client registration, PKCE S256, refresh-token rotation. Members can also mint a long-lived API token by hand. - [YouSpot MCP server](https://youspot.com/docs/mcp.md): Connect Claude, ChatGPT, Cursor or Claude Code to https://youspot.com/mcp/v1 and let an agent read and write your own CRM. - [YouSpot HTTP API](https://youspot.com/docs/api.md): The endpoints YouSpot answers over plain HTTP: public profile data with no auth, and the MCP tool surface with a bearer token. - [YouSpot API versioning, deprecation and rate limits](https://youspot.com/docs/versioning.md): How the YouSpot API is versioned, what notice you get before anything is removed, the RateLimit headers every limited endpoint answers with, and how Idempotency-Key makes a retry safe. - [Paying for YouSpot as an agent](https://youspot.com/docs/payments.md): What YouSpot sells, who can buy it, and the commerce protocols an agent can negotiate against: a UCP discovery profile at /.well-known/ucp and the ACP checkout surface. - [YouSpot security and vulnerability disclosure](https://youspot.com/docs/security.md): How to report a security issue to YouSpot, Inc., what is in scope, and what we commit to in return. A summary of the policy published at /security. ## Machine endpoints - [llms.txt](https://youspot.com/llms.txt): this site, for language models - [llms-full.txt](https://youspot.com/llms-full.txt): the long-form version - [sitemap.xml](https://youspot.com/sitemap.xml): every public page with a last-modified date - [index.md](https://youspot.com/index.md): the home page as markdown - [agents.md](https://youspot.com/agents.md): what an agent can do here, in one page - [MCP server](https://youspot.com/mcp/v1): streamable HTTP; initialize and tools/list need no credential - [MCP server card](https://youspot.com/.well-known/mcp/server-card.json): the endpoint, transport and every tool - [MCP manifest](https://youspot.com/.well-known/mcp.json): every MCP server on this domain, each with its own card - [auth.md](https://youspot.com/auth.md): how an agent gets a credential - [agent identity](https://youspot.com/agent/identity): what identity you can hold here, and who you are holding - [OpenAPI 3.1](https://youspot.com/openapi.json): every HTTP endpoint that exists - [Agent Plugins manifest](https://youspot.com/plugin.json): both MCP servers and the skills, in one bundle - [ChatGPT plugin manifest](https://youspot.com/.well-known/ai-plugin.json): the OpenAI manifest, naming the OpenAPI spec, the OAuth endpoints and the logo - [API catalog](https://youspot.com/.well-known/api-catalog): RFC 9727 - [agent index](https://youspot.com/v1): every endpoint, and what each one costs in credentials - [docs MCP server](https://youspot.com/mcp/docs): the public pages over MCP, no credential at all - [sandbox MCP server](https://youspot.com/mcp/sandbox): the read tools over a demo account, no credential and no signup - [sandbox](https://youspot.com/sandbox): the sandbox described: what is mounted under /sandbox, and whether the demo account is seeded - [ask](https://youspot.com/ask): a question in plain words, answered from these pages - [A2A agent card](https://youspot.com/.well-known/agent-card.json): JSON-RPC at /a2a - [OAuth 2.1 authorization server metadata](https://youspot.com/.well-known/oauth-authorization-server): RFC 8414 - [protected resource metadata](https://youspot.com/.well-known/oauth-protected-resource): RFC 9728 - [Agent Skills index](https://youspot.com/.well-known/agent-skills/index.json): skills an agent can load - [ARD catalog](https://youspot.com/.well-known/ard.json): agent resource discovery - [UCP business profile](https://youspot.com/.well-known/ucp): what an agent can transact with here, and what it cannot - [security.txt](https://youspot.com/.well-known/security.txt): how to report a vulnerability - [Web Bot Auth key directory](https://youspot.com/.well-known/http-message-signatures-directory): the key YouSpot agents sign their own requests with --- # YouSpot for developers and agents > What YouSpot exposes to code: an MCP server, OAuth 2.1, public profile endpoints, and the discovery files that describe them. YouSpot is a personal CRM for AI-native professionals. It builds a second brain from the people, companies, notes and files you already deal with, syncing Gmail, Google Calendar, HubSpot, X and LinkedIn into one graph you can ask in plain English. YouSpot Free is $0 a month with no credit card, YouSpot Pro is $10 a month, and there are no seats to count. YouSpot Pro, 30 days free is $0 today at /pricing/freetrial. Card required. Then $10/month from day 31. Cancel before that and you pay nothing. ## What you can call - **MCP server** at `https://youspot.com/mcp`: streamable HTTP transport, OAuth 2.1 with PKCE S256 and dynamic client registration. This is the primary way an agent reads and writes a member's CRM. - **Public profile endpoints** at `https://youspot.com/api/human/` (also `.json` and `.md`) and `https://youspot.com/api/network/members`: no auth, public data only. - **Discovery files** listed below, so a crawler or an agent can find all of the above without being told. ## Discovery files | Path | What it is | | --- | --- | | `/llms.txt` | this site, for language models | | `/llms-full.txt` | the long-form version | | `/sitemap.xml` | every public page with a last-modified date | | `/index.md` | the home page as markdown | | `/agents.md` | what an agent can do here, in one page | | `/mcp/v1` | streamable HTTP; initialize and tools/list need no credential | | `/.well-known/mcp/server-card.json` | the endpoint, transport and every tool | | `/.well-known/mcp.json` | every MCP server on this domain, each with its own card | | `/auth.md` | how an agent gets a credential | | `/agent/identity` | what identity you can hold here, and who you are holding | | `/openapi.json` | every HTTP endpoint that exists | | `/plugin.json` | both MCP servers and the skills, in one bundle | | `/.well-known/ai-plugin.json` | the OpenAI manifest, naming the OpenAPI spec, the OAuth endpoints and the logo | | `/.well-known/api-catalog` | RFC 9727 | | `/v1` | every endpoint, and what each one costs in credentials | | `/mcp/docs` | the public pages over MCP, no credential at all | | `/mcp/sandbox` | the read tools over a demo account, no credential and no signup | | `/sandbox` | the sandbox described: what is mounted under /sandbox, and whether the demo account is seeded | | `/ask` | a question in plain words, answered from these pages | | `/.well-known/agent-card.json` | JSON-RPC at /a2a | | `/.well-known/oauth-authorization-server` | RFC 8414 | | `/.well-known/oauth-protected-resource` | RFC 9728 | | `/.well-known/agent-skills/index.json` | skills an agent can load | | `/.well-known/ard.json` | agent resource discovery | | `/.well-known/ucp` | what an agent can transact with here, and what it cannot | | `/.well-known/security.txt` | how to report a vulnerability | | `/.well-known/http-message-signatures-directory` | the key YouSpot agents sign their own requests with | ## The CLI, the SDKs and the source The official client is published under the YouSpot name in both ecosystems. Everything except calling a tool works with no credential, so either one is useful before anybody signs in. ```bash npx youspot ask "how do I connect an MCP client" npx youspot tools pip install youspot go get github.com/OnStartups/youspot-go gem install youspot ``` | Where | What | | --- | --- | | [MCP registry: com.youspot/youspot](https://registry.modelcontextprotocol.io/v0/servers?search=com.youspot/youspot) | the official Model Context Protocol registry entry, under a domain-verified namespace. | | [mcp.so: YouSpot MCP](https://mcp.so/servers/youspot) | the directory listing, with the live tool list fetched from this domain. | | [Smithery: youspot/youspot-mcp](https://smithery.ai/servers/youspot/youspot-mcp) | the Smithery listing of the product server, OAuth 2.1, connectable from any Smithery client. | | [npm: youspot](https://www.npmjs.com/package/youspot) | the CLI and the JavaScript SDK. `npx youspot ask "..."` needs no credential. | | [npm: @youspot/mcp](https://www.npmjs.com/package/@youspot/mcp) | the MCP server for clients that only speak stdio. `npx @youspot/mcp` bridges to /mcp/v1. | | [PyPI: youspot](https://pypi.org/project/youspot/) | the Python client. `pip install youspot`. | | [Go: github.com/OnStartups/youspot-go](https://pkg.go.dev/github.com/OnStartups/youspot-go) | the Go client, standard library only. `go get github.com/OnStartups/youspot-go`. | | [RubyGems: youspot](https://rubygems.org/gems/youspot) | the Ruby client, standard library only. `gem install youspot`. | | [GitHub: OnStartups/youspot-agent-tools](https://github.com/OnStartups/youspot-agent-tools) | YouSpot publishes its official CLI, SDK and agent skills from this repository in the OnStartups GitHub organization. | | [skills.sh: official YouSpot skills](https://skills.sh/onstartups/youspot-agent-tools/youspot-mcp) | Published by YouSpot from OnStartups/youspot-agent-tools: MCP access, HTTP API access, and the Solo CRM playbook. Install with `npx skills add OnStartups/youspot-agent-tools`. | The repository carries `AGENTS.md` and `.cursorrules` for coding agents, an Agent Plugins manifest at `plugin.json`, and the three agent skills. It is the same source the packages are built from. ## Reading pages as markdown Every public page answers a markdown twin. Add `.md` to the path, or send `Accept: text/markdown` and get the same body back at the original URL. ```bash curl https://youspot.com/pricing.md curl -H "Accept: text/markdown" https://youspot.com/pricing ``` ## Where to go next - [Authentication](https://youspot.com/docs/authentication): the OAuth 2.1 flow, and the API token a member can mint by hand. - [MCP](https://youspot.com/docs/mcp): connecting Claude, ChatGPT, Cursor and Claude Code, and what the tools do. - [API](https://youspot.com/docs/api): the HTTP surface that needs no MCP client. - [Security](https://youspot.com/docs/security): how to report a vulnerability. --- # YouSpot API authentication > YouSpot is an OAuth 2.1 authorization server for agents: dynamic client registration, PKCE S256, refresh-token rotation. Members can also mint a long-lived API token by hand. YouSpot issues its own OAuth 2.1 access tokens to agents. A token is always bound to one member: every tool call reads and writes that person's data and nobody else's. ## Discovery - `https://youspot.com/.well-known/oauth-protected-resource` (RFC 9728) names the resource and its authorization server. - `https://youspot.com/.well-known/oauth-authorization-server` (RFC 8414) names the endpoints below. ### What identity you can hold `POST https://youspot.com/agent/identity` answers that directly. Send `{"type":"anonymous"}` and it lists the surfaces that need no credential at all. Send `{"type":"service_auth"}` with a bearer token and it names the member whose access you are holding, and whether the credential belongs to a person's AI client or to one of their cloud agents. No other identity type exists here: there is no client-credentials grant, because a token that belonged to no person would have nothing to read. ## Endpoints | Endpoint | Purpose | | --- | --- | | `POST /agent/identity` | What identity you can hold, and who you are holding. No credential needed to ask. | | `POST /oauth/register` | Dynamic client registration (RFC 7591). Open: registration alone grants nothing. | | `GET /oauth/authorize` | Consent. A signed-out person is sent through Clerk first, then shown what the client is asking for. | | `POST /oauth/token` | Authorization code exchange and refresh. Refresh tokens rotate on use. | | `POST /oauth/revoke` | RFC 7009. Revoking either token kills the pair. 200 whether or not the token was live. | ## The flow - Register a client, or reuse one you already registered. - Send the member to `/oauth/authorize` with `response_type=code`, `code_challenge_method=S256`, a `code_challenge`, your `redirect_uri`, and `scope=linkedin`. - They sign in and approve. You get a code on your redirect URI. - Exchange the code at `/oauth/token` with your `code_verifier`. - Call `/mcp` with `Authorization: Bearer `. ### Scope There is one scope, `linkedin`, and it covers the whole tool surface. Finer-grained scopes are not issued yet. ## API tokens A member who wants to script against their own account without running an OAuth flow can mint a named token on the MCP tab at `https://youspot.com/user/integrations/mcp`. Send it the same way, as `Authorization: Bearer `. ```bash curl -X POST https://youspot.com/mcp \ -H "Authorization: Bearer $YOUSPOT_TOKEN" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ## Errors - A missing or expired bearer gets `401` with a `WWW-Authenticate: Bearer` header naming the protected-resource metadata URL, so a client can rediscover where to authorize. - A token belonging to a different member never sees your data; there is no cross-account read. --- # YouSpot MCP server > Connect Claude, ChatGPT, Cursor or Claude Code to https://youspot.com/mcp/v1 and let an agent read and write your own CRM. YouSpot runs a Model Context Protocol server at `https://youspot.com/mcp/v1`. Transport is streamable HTTP; auth is OAuth 2.1, so a client that speaks MCP can connect with no key pasted anywhere. ## Connect a client ### Claude Settings, Connectors, Add custom connector, then paste `https://youspot.com/mcp/v1`. Claude registers itself and opens the consent screen. ### ChatGPT In ChatGPT settings, open Apps or Connectors and create a custom connection named YouSpot with URL `https://youspot.com/mcp/v1` and OAuth authentication. Complete browser consent, then select YouSpot in the conversation. Custom connections may require developer mode, an eligible plan, or workspace administrator approval. Installing YouSpot in Codex or your terminal does not connect ChatGPT web. ### Codex In the desktop app, open Plugins, MCPs, Add, then choose Streamable HTTP. Enter `youspot` as the name and `https://youspot.com/mcp/v1` as the URL. Save and complete sign-in when prompted. You do not need a bearer-token environment variable for OAuth. Restart the app through its restart control to reload the tools. An agent with terminal access can configure Codex for you. It should reuse an existing matching connection rather than overwrite it. To add a missing connection: ```bash codex mcp add youspot --url https://youspot.com/mcp/v1 ``` Current Codex versions start browser sign-in during this command. If sign-in is still needed, run `codex mcp login youspot`. Do not repeat login after it already succeeded. The desktop app, CLI, and IDE extension must load the updated configuration; the IDE has its own restart control. An enabled/OAuth entry in `codex mcp list` does not prove the current chat has loaded the tools. ### Claude Code ```bash claude mcp add --transport http youspot https://youspot.com/mcp/v1 ``` ### Cursor Add this to `~/.cursor/mcp.json`: ```json { "mcpServers": { "youspot": { "url": "https://youspot.com/mcp/v1" } } } ``` ### A client that only speaks stdio Some clients still launch a local process and talk to it on stdin and stdout, and cannot reach a remote server at all. [@youspot/mcp](https://www.npmjs.com/package/@youspot/mcp) is that process: it forwards each JSON-RPC message to `/mcp/v1` and writes the replies back. The client downloads and runs the package; keep the token in its secret settings, not in chat. ```json { "mcpServers": { "youspot": { "command": "npx", "args": ["-y", "@youspot/mcp"], "env": { "YOUSPOT_TOKEN": "..." } } } } ``` If your client speaks streamable HTTP, use the URL above instead. One less moving part. ## Verify in the conversation Configuration, sign-in, loaded tools, and a working tool call are separate steps. After connecting, ask the assistant: ```text Check the YouSpot tools available in this conversation. Use Check connections (list_integrations) to verify my account access. Tell me which call succeeded, what sources are connected, and 3 things you can help me do with the tools you actually have. ``` A successful response from that tool verifies this conversation can use YouSpot. Reading the public tool list, completing OAuth, or calling the endpoint from a terminal does not. If tools are still absent after a restart, inspect the client's MCP connection error rather than repeating sign-in or starting more tasks. Local hook errors such as "No such file or directory" need the failing command identified separately; signing in again does not repair them. Other chat apps need support for remote MCP and OAuth, and may require administrator approval. YouSpot cannot install tools into a host that does not support connectors or bypass its consent controls. Connected sources, approved scopes, available data, and credits determine which workflows can run. ## What the tools do | Family | What it covers | | --- | --- | | Brain graph | Search, read and write the objects in your graph: people, companies, notes, files. | | Attention | What needs you today: unanswered threads, stale follow-ups, upcoming meetings. | | LinkedIn | Query your imported connections and the companies behind them. | | Gmail | Read threads, draft and send mail from a connected mailbox. | | Google Calendar | Read events for context on who you are about to meet. | | HubSpot | Read and sync contacts and companies with a connected portal. | | Company research | Research a company and file the result as an object. | | Prospecting | Find people and companies that match a description. | | Files and imports | Import a file and read what was extracted from it. | | Brand kits and Studio | Import a website's brand, manage brand kits, and generate branded images, emails, documents, and PDFs with the tools your account exposes. | | Domains | Value and suggest domain names. | | Slack, X/Twitter, Obsidian | Read from the other sources a member has connected. | ## What it is not This is not a public web search and not a shared directory. Every tool call is scoped to the signed-in member, so an agent asking "who do I know at Acme" gets that person's network and nobody else's. ## Calling it directly The server is plain JSON-RPC over HTTP POST. `initialize`, `ping` and `tools/list` answer without a credential, so you can handshake and read the tool list before anyone has signed in: ```bash curl -X POST https://youspot.com/mcp/v1 \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` Every `tools/call` needs an OAuth access token or a member API token, because every tool reads one person's own CRM. See [Authentication](https://youspot.com/docs/authentication) or the machine walkthrough at [auth.md](https://youspot.com/auth.md). ```bash curl -X POST https://youspot.com/mcp/v1 \ -H "Authorization: Bearer $YOUSPOT_TOKEN" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_connections_summary","arguments":{}}}' ``` ## Try it without an account A third server at `https://youspot.com/mcp/sandbox` runs the same read tools against a demo account whose contacts, companies and interactions are generated. No credential, no signup, no credits. Every tool that writes is refused there, and the answers are shaped exactly like the answers a real account gives. The same server answers as `/mcp/v1` under the sandbox mount, and `GET https://youspot.com/sandbox` describes that mount and says whether the demo account is seeded. ```bash curl -X POST https://youspot.com/mcp/sandbox \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_graph_objects","arguments":{"query":"Meridian"}}}' ``` ## Machine descriptions | Document | What it holds | | --- | --- | | [Server card](https://youspot.com/.well-known/mcp/server-card.json) | The endpoint, the transport, the protocol versions and every tool. Built from the live tool table, so it cannot claim one that does not exist. `GET /mcp/v1` returns the same document. | | [auth.md](https://youspot.com/auth.md) | Discover, register, consent, exchange, call, revoke. In that order, with runnable requests. | | [api-catalog](https://youspot.com/.well-known/api-catalog) | RFC 9727 linkset pointing at the card, the docs and the OAuth metadata. | `https://youspot.com/mcp` still answers for every client that already has it, so nothing that is connected today has to change. `/mcp/v1` is the URL every discovery document advertises. ## Where this server is listed Every entry is published by us and points back at this domain, which is what makes them verifiable rather than merely present: [com.youspot/youspot](https://registry.modelcontextprotocol.io/v0/servers?search=com.youspot/youspot) in the official Model Context Protocol registry, under a namespace verified by a DNS record on youspot.com; [youspot/youspot-mcp](https://smithery.ai/servers/youspot/youspot-mcp) on Smithery, which connects to `/mcp/v1` over OAuth; and [YouSpot MCP](https://mcp.so/servers/youspot) on mcp.so, whose tool list is fetched live from `/mcp/v1` rather than typed in by hand. --- # YouSpot HTTP API > The endpoints YouSpot answers over plain HTTP: public profile data with no auth, and the MCP tool surface with a bearer token. Most programmatic work here goes through the MCP server, because that is where the tools live. These endpoints answer over plain HTTP for the cases where running an MCP client is not worth it. ## Public, no auth | Endpoint | Returns | | --- | --- | | `GET /api/human/` | A public member profile as JSON. | | `GET /api/human/.json` | The same profile, explicit extension. | | `GET /api/human/.md` | The same profile as markdown. | | `GET /api/network/members` | A page of the public member directory. | ```bash curl https://youspot.com/api/human/dharmesh.json ``` ## Batch `POST /api/batch` runs up to 20 GET requests against the read endpoints in one round trip. Each item comes back with its own `status` and `body` (or `text` for markdown), in the order sent, so one failing item never hides the others: the batch itself is 200 once the envelope is valid. Anything that is not a batchable read is refused per item with the allowlist attached. Each item still counts against its endpoint's own rate limit; the batch saves round trips, not budget. ```bash curl -X POST https://youspot.com/api/batch \ -H "Content-Type: application/json" \ -d '{"requests":[ {"id":"dir","path":"/api/network/members","query":{"q":"consulting","per_page":5}}, {"id":"me","path":"/api/human/dharmesh"} ]}' # 200 { "object": "batch", "count": 2, "responses": [ { "id": "dir", "status": 200, "body": {...} }, { "id": "me", "status": 200, "body": {...} } ] } ``` ## Sandbox Every anonymous path here also answers under `/sandbox`, where `/mcp/v1` becomes the demo-account MCP server: `tools/call` needs no credential and every tool that writes is refused. `GET /sandbox` describes the mount and says whether the demo account is seeded. The OAuth server and the endpoints that need a member are not mounted there. ## Authenticated The tool surface is reached by posting JSON-RPC to `/mcp` with a bearer token. `tools/list` enumerates it and `tools/call` runs one. ```bash curl -X POST https://youspot.com/mcp \ -H "Authorization: Bearer $YOUSPOT_TOKEN" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_connections","arguments":{"query":"acme"}}}' ``` ## Errors A missing or expired bearer gets `401` with a `WWW-Authenticate: Bearer` header naming the protected-resource metadata URL. A tool that fails returns a JSON-RPC result with `isError` set rather than an HTTP error, so a client can read what went wrong. ## Rate limits Tool calls are metered against the member's monthly credits. A member out of credits gets a clear error naming the limit rather than a silent failure. --- # YouSpot API versioning, deprecation and rate limits > How the YouSpot API is versioned, what notice you get before anything is removed, the RateLimit headers every limited endpoint answers with, and how Idempotency-Key makes a retry safe. An agent should not have to guess whether the surface it integrated against will still be there next month. This page is the contract. ## Versioning The API is versioned in the URL path. `/mcp/v1` is the current product MCP server and `/v1` is the agent index. A version never changes meaning underneath you: a breaking change gets a new path, not a new shape at the old one. - Adding an endpoint, a response field, an optional parameter or a new MCP tool is not breaking, and happens without notice. - Removing or renaming a field, tightening a type, or removing an endpoint or tool is breaking, and only ever happens at a new version path. - The OpenAPI document at `/openapi.json` always describes what is live right now. ## Deprecation and sunset A path being retired answers with `Deprecation: true` (RFC 9745) and a `Link` header with `rel="successor-version"` naming what replaces it. Once a removal date is set, the same responses carry `Sunset` (RFC 8594) as an HTTP-date. The commitment: at least 180 days between the first `Sunset` header and the path being removed, and a deprecated path keeps working unchanged for that whole window. Watch for the header rather than polling this page. | Path | State | Use instead | | --- | --- | --- | | `/mcp` | Deprecated, no sunset date set | `/mcp/v1` | | `/mcp/v1` | Current | | | `/mcp/docs` | Current | | | `/mcp/sandbox` | Current | | ```bash curl -sD - -o /dev/null https://youspot.com/mcp # Deprecation: true # Link: ; rel="successor-version" ``` ## Rate limits Every limited endpoint answers with the RFC 9331 headers, so you can pace against the real budget instead of backing off blindly. The dashed triple is sent alongside for clients that parse it. | Header | Meaning | | --- | --- | | `RateLimit` | `"policy";r=;t=` | | `RateLimit-Policy` | `"policy";q=;w=` | | `RateLimit-Limit` | Requests allowed in the window | | `RateLimit-Remaining` | Requests left | | `RateLimit-Reset` | Seconds until the window resets | | `Retry-After` | On a 429: seconds to wait | The sandbox MCP server allows 60 calls a minute per address. A 429 is a JSON-RPC error with code -32003 and a `Retry-After` header. ## Idempotency A dropped connection leaves an agent unable to tell a lost response from a refused request. Send `Idempotency-Key` on a write and the retry is safe: the first answer is replayed rather than the write repeating. - The key is any unique string up to 255 characters. A UUID is the usual choice. - A key is scoped to the credential that sent it, so it replays only your own answer. It does not need to be unguessable. - A recorded answer is replayed for 24 hours, with `Idempotency-Replayed: true`. - The same key with a different request body is a `422`, because that is a client bug rather than a retry. - Honoured on `POST /oauth/register`, `POST /mcp/v1` and `POST /mcp/sandbox`, and declared on those operations in `/openapi.json`. ```bash curl -X POST https://youspot.com/oauth/register \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"redirect_uris":["https://example.com/callback"],"client_name":"My agent"}' ``` ## Work that outlives one request A tool that cannot finish inside one call enqueues instead and answers with `task_id`. Poll `GET /api/jobs/` until `terminal` is true; while it is still going the response carries `Retry-After` with the interval to use. `result` is filled once `state` is `succeeded`. ```bash curl https://youspot.com/api/jobs/8412 \ -H "Authorization: Bearer $YOUSPOT_TOKEN" # {"job_id":8412,"kind":"file_import","state":"running","terminal":false,...} ``` You can also start one over plain HTTP. `POST /api/jobs` with a `kind` answers `202 Accepted` and a `Location` header naming the job, which is the same URL as `poll` in the body. Starting a kind that is already running reports the running job rather than queuing a second one, so a retry is safe on its own. ```bash curl -i -X POST https://youspot.com/api/jobs \ -H "Authorization: Bearer $YOUSPOT_TOKEN" \ -H "Content-Type: application/json" \ -d '{"kind":"embed_objects"}' # HTTP/1.1 202 Accepted # Location: https://youspot.com/api/jobs/8413 # Retry-After: 5 ``` --- # Paying for YouSpot as an agent > What YouSpot sells, who can buy it, and the commerce protocols an agent can negotiate against: a UCP discovery profile at /.well-known/ucp and the ACP checkout surface. The short version: an agent cannot buy YouSpot yet. A person can, and an agent can then work inside that account over OAuth. This page says so in the shape the commerce protocols define, so an agent learns it by reading rather than by guessing at a 404. ## What is for sale | Plan | Price | Included | | --- | --- | --- | | YouSpot Free | $0 a month, no credit card | Use up to 50 credits/month | | YouSpot Pro | $10 a month | Use up to 1,000 credits/month | Every new account starts on YouSpot Free: sign up at https://youspot.com/pricing and it is provisioned with no card. YouSpot Pro is bought by a signed-in person from the same page, which hands over to Stripe. Credit packs are bought the same way from the billing tab. There is no seat count and no annual commitment. What costs nothing: the docs MCP server at /mcp/docs, the sandbox MCP server at /mcp/sandbox, every markdown twin, /ask, and the read side of the A2A agent. None of them take a credential, so an agent evaluating YouSpot never has to pay to find out what it does. ### What a credit is spent on Only the model does. One credit per chat message and one per app run, charged after the work succeeded, so a failed turn costs nothing. Storage, syncing and file exchange are not metered at all: reading your graph, importing from a connected mailbox, syncing a HubSpot portal and downloading a file are free at any volume your plan allows. | Action | Cost | | --- | --- | | Chat message, or an agent draft | 1 credit | | App run (ImageGen, ProspectFinder, DomainValue and the rest) | 1 credit | | Reading, searching or writing your graph over MCP or REST | free | | Mailbox, calendar, HubSpot, LinkedIn and X sync | free | | File upload and download | free | What bounds the free half is not price but shape: a per-address rate limit, declared on every response in the RFC 9331 `RateLimit` headers, and a hard cap on object count and file size per plan. An agent that paces against the headers never meets either. See /docs/versioning for the header table. ## UCP discovery The business profile is published at https://youspot.com/.well-known/ucp against Universal Commerce Protocol 2026-08-25. It advertises the three transports an agent can reach YouSpot over (REST, MCP and A2A), the identity-linking capability that OAuth 2.1 provides, and an empty payment-handler registry. The empty registry is the point rather than an omission. UCP requires the member to be present even when it holds nothing, which is how a reader tells "no agent payment handler" apart from "this profile forgot to mention one". ```bash curl -s https://youspot.com/.well-known/ucp | jq '.ucp.payment_handlers, .checkout.status' # {} # "not_supported" ``` ## ACP checkout The Agentic Commerce Protocol endpoints exist and negotiate: POST /checkout_sessions and POST /agentic_commerce/delegate_payment. Both answer 501 with a protocol-level ACP error naming the version they speak, 2026-04-17. A preflight OPTIONS returns 204 and allows POST. | Request | Answer | | --- | --- | | `OPTIONS /checkout_sessions` | `204`, `Access-Control-Allow-Methods: POST, OPTIONS` | | `POST /checkout_sessions` | `501` with `type: service_unavailable`, `code: checkout_not_supported` | | `POST /agentic_commerce/delegate_payment` | the same 501 | The error carries only the four members the ACP schema allows, because it refuses additional properties: type, code, message and supported_versions. Everything an agent should do instead is in the message. ## What would change this Agent-initiated checkout needs a payment credential YouSpot can charge without a person present: a delegated payment token from the buyer's agent, or a stablecoin rail such as x402. Both are decisions about the product, not about this page. When one ships, the payment-handler registry in the UCP profile stops being empty and these endpoints stop answering 501. --- # YouSpot security and vulnerability disclosure > How to report a security issue to YouSpot, Inc., what is in scope, and what we commit to in return. A summary of the policy published at /security. YouSpot, Inc. welcomes reports from security researchers. Email **andrei@mail.youspot.com**. Reports may be submitted anonymously. ## In scope - `https://youspot.com`, the web application. - `https://be.youspot.com`, the API. Anything not listed is out of scope, including the third-party services YouSpot integrates with (Clerk, Supabase, Stripe, Google APIs, Anthropic, OpenAI). Report those to the vendor. If you are unsure, ask before you start. ## Not authorized - Denial-of-service testing, network or application level. - Physical testing and social engineering, including phishing. ## What we ask - Tell us as soon as you find something. - Give us at least 90 days from acknowledgment before publishing. - Use an exploit only far enough to confirm the issue exists. Do not pivot, persist, or pull data. - If you reach personal data, stop, tell us, and keep it confidential. ## What to include - What the vulnerability is. - Where you found it: the URL or endpoint. - What an attacker could do with it. - Steps to reproduce. Scripts and screenshots are welcome. ## What we commit to We acknowledge a report within three business days, keep you posted through confirmation and remediation, and will not pursue legal action over research conducted in line with this policy. The full Vulnerability Disclosure Policy is published at [youspot.com/security](https://youspot.com/security); the machine-readable contact is `https://youspot.com/.well-known/security.txt`. --- # YouSpot MCP server > The product MCP server: one member's own contacts, companies, notes and files, over OAuth 2.1. ## Connecting - Endpoint: `https://youspot.com/mcp/v1` - Transport: streamable HTTP, JSON-RPC 2.0 - Protocol versions: `2025-06-18`, `2025-03-26` - Credential: A bearer token for `tools/call`. `initialize`, `ping` and `tools/list` answer anonymously, so a client can handshake before anyone signs in. ```bash curl -X POST https://youspot.com/mcp/v1 \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ## Tools - `tools/list`: The live tool table, with a typed `inputSchema` and read-only and destructive hints on each. It is the authority; the server card carries names and summaries only. ## Notes - JSON-RPC batching is refused, per MCP 2025-06-18. - `/mcp` is the same server under its old path. It is deprecated and answers with `Deprecation: true`. - Send `Idempotency-Key` on a call you may retry: the first answer is replayed rather than the write repeating. - A tool that cannot finish in one call answers with `task_id`. Poll `/api/jobs/`. ## Related - [Server card](https://youspot.com/mcp/v1) over GET, and at [/.well-known/mcp/server-card.json](https://youspot.com/.well-known/mcp/server-card.json) - [MCP documentation](https://youspot.com/docs/mcp) - [Versioning, deprecation and rate limits](https://youspot.com/docs/versioning) - [OpenAPI](https://youspot.com/openapi.json) --- # YouSpot documentation MCP server > Search and read YouSpot's public pages and developer documentation. No credential, no signup. ## Connecting - Endpoint: `https://youspot.com/mcp/docs` - Transport: streamable HTTP, JSON-RPC 2.0 - Protocol versions: `2025-06-18`, `2025-03-26` - Credential: None. Everything it reads is a page anybody can already fetch. ```bash curl -X POST https://youspot.com/mcp/docs \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ## Tools - `search_docs`: Search the public pages and developer docs. Returns each matching page with the passage that matched and its URL. - `read_doc`: Read one public page in full, as markdown, by the path search_docs returned. - `list_docs`: Every public page with its title and one-line description, optionally narrowed to one section. ## Notes - Exposes `ui://youspot/docs-results` as an MCP Apps view, so a host that can render shows the results as a list instead of a wall of text. - Also serves every documentation page as an MCP resource over `resources/list`. ## Related - [Server card](https://youspot.com/mcp/docs) over GET, and at [/.well-known/mcp/docs-server-card.json](https://youspot.com/.well-known/mcp/docs-server-card.json) - [MCP documentation](https://youspot.com/docs/mcp) - [Versioning, deprecation and rate limits](https://youspot.com/docs/versioning) - [OpenAPI](https://youspot.com/openapi.json) --- # YouSpot sandbox MCP server > Every YouSpot read tool, with no credential, over a demo account whose contacts and interactions are generated. Try the tools before connecting a real one. ## Connecting - Endpoint: `https://youspot.com/mcp/sandbox` - Transport: streamable HTTP, JSON-RPC 2.0 - Protocol versions: `2025-06-18`, `2025-03-26` - Credential: None. No signup, and nothing here costs credits. ```bash curl -X POST https://youspot.com/mcp/sandbox \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ## Tools - `tools/list`: The read half of the product tool table. Write tools are not listed and not callable here. ## Notes - The data belongs to a fictional consultant and resets to the same fixture. Nothing here is a customer record. - Rate limited to 60 calls a minute per address, declared in the `RateLimit` headers on every response. - Connect `/mcp/v1` for the write tools and for real data. ## Related - [Server card](https://youspot.com/mcp/sandbox) over GET, and at [/.well-known/mcp/sandbox-server-card.json](https://youspot.com/.well-known/mcp/sandbox-server-card.json) - [MCP documentation](https://youspot.com/docs/mcp) - [Versioning, deprecation and rate limits](https://youspot.com/docs/versioning) - [OpenAPI](https://youspot.com/openapi.json) --- # What, why, and who is this? > A letter from Dharmesh Shah about what YouSpot is, why it exists, and who it is for. By Dharmesh Shah, Co-founder and CTO, HubSpot. July 2026. ## What is this? YouSpot is a personal CRM. Not a CRM for your company, HubSpot does that, and does it well. This one is for you: the people you know, the conversations you have had, the follow-ups you meant to send. You talk to it the way you would talk to a person who happened to remember everything. "Who do I know at Gusto?" "Which invitations did I never answer?" It just answers. ## Why does it exist? Because I have thousands of connections and remember approximately none of the details. The tools I tried all wanted me to maintain them: fields to fill, stages to advance, a discipline I was never going to keep up. The interesting shift is that an AI does not need the tidy database first. It can work from the mess: your exports, your inbox, your actual history. That is the bet here. It is not AI bolted onto a CRM. It is a CRM that only makes sense because the AI came first. ## Who is it for? Solo professionals. Founders, investors, consultants, salespeople, connectors, anyone whose network is a real asset but who has no team, no ops person, and no interest in becoming a database administrator on the side. If you have ever failed to remember where you met someone right as you were shaking their hand again, it is for you. ## More - [Pricing](https://youspot.com/pricing) - [Second Brain](https://youspot.com/secondbrain) - [Docs for developers and agents](https://youspot.com/docs) --- # Brand > Every YouSpot logo, in every format, plus the colour, type and written guidelines. Free to use for press, partners and anyone writing about YouSpot. ## Download the kit - **Everything**: Logos, app icons, Illustrator source and the written guidelines. [Download](https://youspot.com/brand/kit/full) - **Logos and icons**: Every variation, SVG and PNG, plus the app icons. [Download](https://youspot.com/brand/kit/logos) - **Guidelines**: The design system and the written brand, as markdown. [Download](https://youspot.com/brand/kit/docs) ## Logos ### Primary lockup The logo as delivered: disc and wordmark as one path in HubSpot Orange. It reads on ivory and on plum, so this is the default everywhere unless the ground fights it. [SVG](https://youspot.com/brand/youspot-logo-v5.svg) · [PNG 1200](https://youspot.com/brand/youspot-logo-v5.png) · [PNG 2400](https://youspot.com/brand/youspot-logo-v5-2400.png) ### Lockup, light wordmark Orange disc, white Spot. For dark grounds (plum chrome, photography, a dark deck) where the orange wordmark loses contrast. [SVG](https://youspot.com/brand/youspot-logo-v5-light.svg) · [PNG 1200](https://youspot.com/brand/youspot-logo-v5-light.png) · [PNG 2400](https://youspot.com/brand/youspot-logo-v5-light-2400.png) ### Lockup, ink wordmark Orange disc, ink Spot. For light grounds that need the wordmark quieter than the disc: a document, a slide, a partner page that is already carrying colour. [SVG](https://youspot.com/brand/youspot-logo-v5-dark.svg) · [PNG 1200](https://youspot.com/brand/youspot-logo-v5-dark.png) · [PNG 2400](https://youspot.com/brand/youspot-logo-v5-dark-2400.png) ### Icon The disc alone, with You knocked out of it. Whatever sits behind the artwork shows through the letters, so use it where the ground is flat and light. [SVG](https://youspot.com/brand/youspot-icon-v5.svg) · [PNG 512](https://youspot.com/brand/youspot-icon-v5.png) · [PNG 1024](https://youspot.com/brand/youspot-icon-v5-1024.png) ### Icon, solid The same disc with a white circle behind the knockout, so You reads white on any ground. This is the one for avatars, favicons and anything sitting on artwork. [SVG](https://youspot.com/brand/youspot-icon-v5-solid.svg) · [PNG 512](https://youspot.com/brand/youspot-icon-v5-solid.png) · [PNG 1024](https://youspot.com/brand/youspot-icon-v5-solid-1024.png) ### App icons Built from the solid icon: a multi-size ICO for browser tabs and a 180px PNG for the iOS home screen, both flattened onto white because neither surface can be trusted with transparency. [ICO 16/32/48](https://youspot.com/brand/favicon.ico) · [PNG 180](https://youspot.com/brand/apple-touch-icon.png) ## Previous version ### Lockup (v4) The previous lockup. Kept for anything already printed; do not start with it. [PNG 317](https://youspot.com/brand/youspot-logo-v4.png) ### Lockup, dark ground (v4) The previous lockup for dark grounds. [PNG 317](https://youspot.com/brand/youspot-logo-v4-dark.png) ### Icon (v4) The previous icon, knockout build. [PNG 512](https://youspot.com/brand/youspot-icon-v4.png) ### Icon, solid (v4) The previous icon with the white disc behind the knockout. [PNG 512](https://youspot.com/brand/youspot-icon-v4-solid.png) ## Using the logo - **Keep clear space**: Leave the height of the disc empty on every side. Nothing crops into it. - **Pick the build for the ground**: Light wordmark on dark, ink wordmark on busy light, primary everywhere else. - **Do not recolour it**: The orange is the brand. A tinted, greyscale or gradient logo is a different logo. - **Do not stretch or rotate it**: Scale both axes together, and keep it level. - **Do not rebuild the wordmark**: The lettering is drawn, not typeset. No font reproduces it, so use the file. - **Do not put the knockout icon on artwork**: The letters show whatever is behind them. On a photo or a colour, use the solid build. ## Colour | Name | Token | Hex | Used for | | --- | --- | --- | --- | | HubSpot Orange | `brand` | #ff4800 | The logo, and the one accent that carries it | | Primary | `primary` | #ff4800 | Buttons and links; the same orange | | Plum | `chrome` | #3a0b24 | Nav and dark chrome | | Ivory | `background` | #f7efe9 | The page ground | | Ink | `foreground` | #141413 | Body copy | | Surface | `surface` | #f2e7df | Raised panels on the page | | Salmon | `selected` | #f6c3ad | Selection and current state | | Muted | `muted-foreground` | #6b675e | Secondary copy | | Border | `border` | #e4e0d6 | Hairlines and dividers | ## Type - **Georgia** (`font-display`, Georgia, serif): Display copy: headlines and pull quotes - **System sans** (`font-sans`, system-ui): Body, titles and every interface label - **Caveat** (`font-accent`, Caveat, cursive): The handwriting accent, one word at a time - **Geist Mono** (`font-mono`, Geist Mono, monospace): Eyebrows, code and anything tabular ## Guidelines and source - [The design system](https://youspot.com/brand/docs/design-system.md): Principles, the token contract, and where every value actually lives. - [Brand voice](https://youspot.com/brand/docs/brand-voice.md): How YouSpot sounds, with the words it does and does not use. - [Naming guidelines](https://youspot.com/brand/docs/naming-guidelines.md): How features and surfaces get their names. - [Writing style guide](https://youspot.com/brand/docs/writing-style-guide.md): Punctuation, capitalisation and the house rules for product copy. - [YouSpot-Logotype.ai](https://youspot.com/brand/source/YouSpot-Logotype.ai): the Illustrator source, as delivered. - [YouSpot-Icon.ai](https://youspot.com/brand/source/YouSpot-Icon.ai): the Illustrator source, as delivered. ## Questions Email support@youspot.com. --- # Support > Questions, bugs, or something that just looks off: email support@youspot.com and a human answers. ## Getting help Email **support@youspot.com**. Every email opens a tracked ticket, so nothing gets lost. Include a screenshot and the page URL if you can, it helps us fix things faster. ## Feature ideas Send them to **ideas@youspot.com** and they join the public [ideas board](https://youspot.com/ideas). ## Security Report a vulnerability to **andrei@mail.youspot.com**. See the [vulnerability disclosure policy](https://youspot.com/security). ## More - [Docs](https://youspot.com/docs) - [Pricing](https://youspot.com/pricing) - [Privacy](https://youspot.com/privacy), [Terms](https://youspot.com/terms)