@oneshot-agent/mcp-server 0.36.0 → 0.37.0

package/README.md

@@ -169,12 +169,12 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 | Tool | Description |
 |------|-------------|
 | `oneshot_research` | Deep web research with sources |
-| `oneshot_people_search` | Search for people by title, company, etc. |
-| `oneshot_enrich_profile` | Enrich person profile from LinkedIn/email |
-| `oneshot_find_email` | Find someone's email address |
-| `oneshot_verify_email` | Verify email deliverability |
-| `oneshot_company_search` | Search for companies by industry, size, location, etc. |
-| `oneshot_enrich_company` | Enrich a company from domain, name, LinkedIn, or ticker |
+| `oneshot_person_find` | Search for people by title, company, etc. |
+| `oneshot_person_profile` | Enrich person profile from LinkedIn/email |
+| `oneshot_person_email` | Find someone's email address |
+| `oneshot_person_email_status` | Verify email deliverability |
+| `oneshot_company_find` | Search for companies by industry, size, location, etc. |
+| `oneshot_company_profile` | Enrich a company from domain, name, LinkedIn, or ticker |
 | `oneshot_business_find` | Discover local businesses (restaurants, contractors, practices) by category × location |
 | `oneshot_business_resolve` | Business name + address → website domain, phone, status, confidence |
 | `oneshot_record_solicitations_find` | Federal Sources Sought / Presolicitation notices by NAICS with the contracting officer's contact |
@@ -183,12 +183,12 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 
 | Tool | Description |
 |------|-------------|
-| `oneshot_deep_research_person` | Full dossier on a person |
-| `oneshot_social_profiles` | Find all social accounts for a person |
-| `oneshot_article_search` | Find articles about a person |
-| `oneshot_person_newsfeed` | Recent social posts with engagement |
+| `oneshot_person_dossier` | A person’s profile, known social accounts, articles, posts and written summary |
+| `oneshot_person_social_accounts` | Find all social accounts for a person |
+| `oneshot_person_articles` | Find articles about a person |
+| `oneshot_person_posts` | Recent social posts with engagement |
 | `oneshot_person_interests` | Analyze interests across categories |
-| `oneshot_person_interactions` | Map followers, following, replies |
+| `oneshot_person_followers` | Map followers, following, replies |
 
 ### Web
 
@@ -298,7 +298,7 @@ Use oneshot_research:
 ### Search for People
 
 ```
-Use oneshot_people_search:
+Use oneshot_person_find:
 - job_titles: ["CTO", "VP Engineering"]
 - companies: ["Stripe", "Square"]
 - location: ["San Francisco"]
@@ -308,7 +308,7 @@ Use oneshot_people_search:
 ### Find Someone's Email
 
 ```
-Use oneshot_find_email:
+Use oneshot_person_email:
 - first_name: "John"
 - last_name: "Smith"
 - company_domain: "example.com"
@@ -350,7 +350,7 @@ Send USDC to your agent's wallet address on Base. The server runs on Base Mainne
 
 ## LinkedIn connection recovery
 
-If the active account list is empty or an account is `deleted_upstream` or
+If the active account list is empty or an account is `connection_deleted` or
 `revoked`, ask the human to use `oneshot_linkedin_connect` and authorize fresh
 grants. An existing account with `reconnect_required` must be reconnected through
 the owning application. Reconnect and revoke are deliberately not agent tools.

package/dist/index.js

@@ -50,7 +50,7 @@ async function main() {
     const agent = await initAgent();
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.36.0", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.37.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/dist/tools/annotations.js

@@ -25,19 +25,19 @@ export const TOOL_ANNOTATIONS = {
     oneshot_voice_inbound_disable: write("Stop answering calls", OPEN),
     oneshot_voice_inbound_calls: read("List answered calls", OWN),
     oneshot_research: read("Deep research", OPEN),
-    oneshot_people_search: read("Find people", OPEN),
-    oneshot_enrich_profile: read("Look up a person's profile", OPEN),
-    oneshot_find_email: read("Find a work email", OPEN),
-    oneshot_verify_email: read("Verify an email address", OPEN),
+    oneshot_person_find: read("Find people", OPEN),
+    oneshot_person_profile: read("Look up a person's profile", OPEN),
+    oneshot_person_email: read("Find a work email", OPEN),
+    oneshot_person_email_status: read("Verify an email address", OPEN),
     oneshot_web_search: read("Web search", OPEN),
-    oneshot_deep_research_person: read("Research a person", OPEN),
-    oneshot_social_profiles: read("Find social profiles", OPEN),
-    oneshot_article_search: read("Find articles about a person", OPEN),
-    oneshot_person_newsfeed: read("Get a person's recent posts", OPEN),
+    oneshot_person_dossier: read("Research a person", OPEN),
+    oneshot_person_social_accounts: read("Find social profiles", OPEN),
+    oneshot_person_articles: read("Find articles about a person", OPEN),
+    oneshot_person_posts: read("Get a person's recent posts", OPEN),
     oneshot_person_interests: read("Summarize a person's interests", OPEN),
-    oneshot_person_interactions: read("Find a person's interactions", OPEN),
-    oneshot_company_search: read("Find companies", OPEN),
-    oneshot_enrich_company: read("Look up a company", OPEN),
+    oneshot_person_followers: read("Find a person's interactions", OPEN),
+    oneshot_company_find: read("Find companies", OPEN),
+    oneshot_company_profile: read("Look up a company", OPEN),
     oneshot_business_find: read("Find local businesses", OPEN),
     oneshot_business_resolve: read("Look up a local business", OPEN),
     oneshot_record_solicitations_find: read("Find government contracts", OPEN),

package/dist/tools/company.d.ts

@@ -1,6 +1,6 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
 import type { OneShot } from "@oneshot-agent/sdk";
-export declare const companySearchTool: Tool;
-export declare const enrichCompanyTool: Tool;
-export declare function handleCompanySearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CompanySearchResult>;
-export declare function handleEnrichCompany(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").EnrichCompanyResult>;
+export declare const companyFindTool: Tool;
+export declare const companyProfileTool: Tool;
+export declare function handleCompanyFind(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CompanyFindResult>;
+export declare function handleCompanyProfile(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CompanyProfileResult>;

package/dist/tools/company.js

@@ -1,5 +1,5 @@
-export const companySearchTool = {
-    name: "oneshot_company_search",
+export const companyFindTool = {
+    name: "oneshot_company_find",
     description: "Search for companies by name, domain, industry, location, size, funding stage, or tags. Paid tool.",
     inputSchema: {
         type: "object",
@@ -17,8 +17,8 @@ export const companySearchTool = {
         },
     },
 };
-export const enrichCompanyTool = {
-    name: "oneshot_enrich_company",
+export const companyProfileTool = {
+    name: "oneshot_company_profile",
     description: "Enrich a company from its domain, name, LinkedIn URL, or stock ticker. At least one identifier is required. Paid tool.",
     inputSchema: {
         type: "object",
@@ -30,8 +30,8 @@ export const enrichCompanyTool = {
         },
     },
 };
-export async function handleCompanySearch(agent, args) {
-    return agent.companySearch({
+export async function handleCompanyFind(agent, args) {
+    return agent.companyFind({
         name: args.name,
         domain: args.domain,
         industry: args.industry,
@@ -44,8 +44,8 @@ export async function handleCompanySearch(agent, args) {
         limit: args.limit,
     });
 }
-export async function handleEnrichCompany(agent, args) {
-    return agent.enrichCompany({
+export async function handleCompanyProfile(agent, args) {
+    return agent.companyProfile({
         domain: args.domain,
         name: args.name,
         linkedin_url: args.linkedin_url,

package/dist/tools/enrichment.d.ts

@@ -1,8 +1,8 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
 import type { OneShot } from "@oneshot-agent/sdk";
-export declare const enrichProfileTool: Tool;
-export declare const findEmailTool: Tool;
-export declare const verifyEmailTool: Tool;
-export declare function handleEnrichProfile(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").EnrichProfileResult>;
-export declare function handleFindEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").FindEmailResult>;
-export declare function handleVerifyEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").VerifyEmailResult>;
+export declare const personProfileTool: Tool;
+export declare const personEmailTool: Tool;
+export declare const personEmailStatusTool: Tool;
+export declare function handlePersonProfile(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonProfileResult>;
+export declare function handlePersonEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonEmailResult>;
+export declare function handlePersonEmailStatus(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonEmailStatusResult>;

package/dist/tools/enrichment.js

@@ -1,5 +1,5 @@
-export const enrichProfileTool = {
-    name: "oneshot_enrich_profile",
+export const personProfileTool = {
+    name: "oneshot_person_profile",
     description: "Enrich a person's profile from LinkedIn URL, email, or name. Returns job title, company, social links, etc. Paid tool.",
     inputSchema: {
         type: "object",
@@ -23,8 +23,8 @@ export const enrichProfileTool = {
         },
     },
 };
-export const findEmailTool = {
-    name: "oneshot_find_email",
+export const personEmailTool = {
+    name: "oneshot_person_email",
     description: "Find email address for a person at a company. Paid tool.",
     inputSchema: {
         type: "object",
@@ -49,8 +49,8 @@ export const findEmailTool = {
         required: ["company_domain"],
     },
 };
-export const verifyEmailTool = {
-    name: "oneshot_verify_email",
+export const personEmailStatusTool = {
+    name: "oneshot_person_email_status",
     description: "Verify if an email address is valid and deliverable. Paid tool.",
     inputSchema: {
         type: "object",
@@ -63,24 +63,24 @@ export const verifyEmailTool = {
         required: ["email"],
     },
 };
-export async function handleEnrichProfile(agent, args) {
-    return agent.enrichProfile({
+export async function handlePersonProfile(agent, args) {
+    return agent.personProfile({
         linkedin_url: args.linkedin_url,
         email: args.email,
         name: args.name,
         company_domain: args.company_domain,
     });
 }
-export async function handleFindEmail(agent, args) {
-    return agent.findEmail({
+export async function handlePersonEmail(agent, args) {
+    return agent.personEmail({
         full_name: args.full_name,
         first_name: args.first_name,
         last_name: args.last_name,
         company_domain: args.company_domain,
     });
 }
-export async function handleVerifyEmail(agent, args) {
-    return agent.verifyEmail({
+export async function handlePersonEmailStatus(agent, args) {
+    return agent.personEmailStatus({
         email: args.email,
     });
 }

package/dist/tools/index.js

@@ -3,9 +3,9 @@ import { voiceTool, handleVoice } from "./voice.js";
 import { voiceNumberProvisionTool, voiceNumbersTool, voiceInboundSetTool, voiceInboundDisableTool, voiceInboundCallsTool, handleVoiceNumberProvision, handleVoiceNumbers, handleVoiceInboundSet, handleVoiceInboundDisable, handleVoiceInboundCalls, } from "./voice-inbound.js";
 import { smsTool, handleSms } from "./sms.js";
 import { researchTool, handleResearch } from "./research.js";
-import { peopleSearchTool, handlePeopleSearch } from "./people.js";
+import { personFindTool, handlePersonFind } from "./people.js";
 import { commerceSearchTool, commerceBuyTool, handleCommerceSearch, handleCommerceBuy } from "./commerce.js";
-import { enrichProfileTool, findEmailTool, verifyEmailTool, handleEnrichProfile, handleFindEmail, handleVerifyEmail } from "./enrichment.js";
+import { personProfileTool, personEmailTool, personEmailStatusTool, handlePersonProfile, handlePersonEmail, handlePersonEmailStatus } from "./enrichment.js";
 import { inboxListTool, inboxGetTool, handleInboxList, handleInboxGet } from "./inbox.js";
 import { smsInboxListTool, smsInboxGetTool, handleSmsInboxList, handleSmsInboxGet } from "./sms-inbox.js";
 import { notificationsTool, markReadTool, handleNotifications, handleMarkRead } from "./notifications.js";
@@ -15,8 +15,8 @@ import { buildTool, updateBuildTool, handleBuild, handleUpdateBuild } from "./bu
 import { browserTool, browserCreateProfileTool, browserListProfilesTool, browserDeleteProfileTool, handleBrowser, handleBrowserCreateProfile, handleBrowserListProfiles, handleBrowserDeleteProfile } from "./browser.js";
 import { webSearchTool, handleWebSearch } from "./search.js";
 import { webReadTool, handleWebRead } from "./web-read.js";
-import { deepResearchPersonTool, socialProfilesTool, articleSearchTool, personNewsfeedTool, personInterestsTool, personInteractionsTool, handleDeepResearchPerson, handleSocialProfiles, handleArticleSearch, handlePersonNewsfeed, handlePersonInterests, handlePersonInteractions } from "./nyne.js";
-import { companySearchTool, enrichCompanyTool, handleCompanySearch, handleEnrichCompany } from "./company.js";
+import { personDossierTool, personSocialAccountsTool, personArticlesTool, personPostsTool, personInterestsTool, personFollowersTool, handlePersonDossier, handlePersonSocialAccounts, handlePersonArticles, handlePersonPosts, handlePersonInterests, handlePersonFollowers } from "./nyne.js";
+import { companyFindTool, companyProfileTool, handleCompanyFind, handleCompanyProfile } from "./company.js";
 import { businessFindTool, businessResolveTool, handleBusinessFind, handleBusinessResolve } from "./local.js";
 import { recordSolicitationsFindTool, handleRecordSolicitationsFind } from "./gov.js";
 import { linkedinConnectTool, linkedinAccountsTool, linkedinSyncTool, linkedinConversationsTool, linkedinMessagesTool, linkedinReplyTool, linkedinViewProfileTool, linkedinReactTool, linkedinInviteTool, linkedinWithdrawInvitationTool, linkedinMessageTool, linkedinInvitationTool, linkedinInvitationsTool, handleLinkedinConnect, handleLinkedinAccounts, handleLinkedinSync, handleLinkedinConversations, handleLinkedinMessages, handleLinkedinReply, handleLinkedinViewProfile, handleLinkedinReact, handleLinkedinInvite, handleLinkedinWithdrawInvitation, handleLinkedinMessage, handleLinkedinInvitation, handleLinkedinInvitations, } from "./linkedin.js";
@@ -40,19 +40,19 @@ const toolDefinitions = [
     voiceInboundDisableTool,
     voiceInboundCallsTool,
     researchTool,
-    peopleSearchTool,
-    enrichProfileTool,
-    findEmailTool,
-    verifyEmailTool,
+    personFindTool,
+    personProfileTool,
+    personEmailTool,
+    personEmailStatusTool,
     webSearchTool,
-    deepResearchPersonTool,
-    socialProfilesTool,
-    articleSearchTool,
-    personNewsfeedTool,
+    personDossierTool,
+    personSocialAccountsTool,
+    personArticlesTool,
+    personPostsTool,
     personInterestsTool,
-    personInteractionsTool,
-    companySearchTool,
-    enrichCompanyTool,
+    personFollowersTool,
+    companyFindTool,
+    companyProfileTool,
     businessFindTool,
     businessResolveTool,
     recordSolicitationsFindTool,
@@ -130,19 +130,19 @@ const handlers = {
     "oneshot_voice_inbound_disable": handleVoiceInboundDisable,
     "oneshot_voice_inbound_calls": handleVoiceInboundCalls,
     "oneshot_research": handleResearch,
-    "oneshot_people_search": handlePeopleSearch,
-    "oneshot_enrich_profile": handleEnrichProfile,
-    "oneshot_find_email": handleFindEmail,
-    "oneshot_verify_email": handleVerifyEmail,
+    "oneshot_person_find": handlePersonFind,
+    "oneshot_person_profile": handlePersonProfile,
+    "oneshot_person_email": handlePersonEmail,
+    "oneshot_person_email_status": handlePersonEmailStatus,
     "oneshot_web_search": handleWebSearch,
-    "oneshot_deep_research_person": handleDeepResearchPerson,
-    "oneshot_social_profiles": handleSocialProfiles,
-    "oneshot_article_search": handleArticleSearch,
-    "oneshot_person_newsfeed": handlePersonNewsfeed,
+    "oneshot_person_dossier": handlePersonDossier,
+    "oneshot_person_social_accounts": handlePersonSocialAccounts,
+    "oneshot_person_articles": handlePersonArticles,
+    "oneshot_person_posts": handlePersonPosts,
     "oneshot_person_interests": handlePersonInterests,
-    "oneshot_person_interactions": handlePersonInteractions,
-    "oneshot_company_search": handleCompanySearch,
-    "oneshot_enrich_company": handleEnrichCompany,
+    "oneshot_person_followers": handlePersonFollowers,
+    "oneshot_company_find": handleCompanyFind,
+    "oneshot_company_profile": handleCompanyProfile,
     "oneshot_business_find": handleBusinessFind,
     "oneshot_business_resolve": handleBusinessResolve,
     "oneshot_record_solicitations_find": handleRecordSolicitationsFind,

package/dist/tools/linkedin.js

@@ -7,7 +7,7 @@
 const GRANT_ACTIONS = ["read", "reply", "view_profile", "react", "invite", "comment"];
 export const linkedinConnectTool = {
     name: "oneshot_linkedin_connect",
-    description: "Create a hosted LinkedIn login link for a human to connect THEIR OWN LinkedIn account to this agent, granting specific actions (read, reply, view_profile, react, invite). Returns intent_id + url (show the url to the human; it expires in 30 minutes; never embed it in an iframe). Poll oneshot_linkedin_accounts with the intent_id afterwards. Free tool. If no active account exists, or status is deleted_upstream/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
+    description: "Create a hosted LinkedIn login link for a human to connect THEIR OWN LinkedIn account to this agent, granting specific actions (read, reply, view_profile, react, invite). Returns intent_id + url (show the url to the human; it expires in 30 minutes; never embed it in an iframe). Poll oneshot_linkedin_accounts with the intent_id afterwards. Free tool. If no active account exists, or status is connection_deleted/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
     inputSchema: {
         type: "object",
         properties: {
@@ -20,7 +20,7 @@ export const linkedinConnectTool = {
 };
 export const linkedinAccountsTool = {
     name: "oneshot_linkedin_accounts",
-    description: "List the LinkedIn accounts connected to this agent (status, granted actions, sync coverage), or, with intent_id, check a pending connection from oneshot_linkedin_connect (pending → completed with the account, or failed with a reason). Free tool. If no active account exists, or status is deleted_upstream/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
+    description: "List the LinkedIn accounts connected to this agent (status, granted actions, sync coverage), or, with intent_id, check a pending connection from oneshot_linkedin_connect (pending → completed with the account, or failed with a reason). Free tool. If no active account exists, or status is connection_deleted/revoked, ask the human to connect again with oneshot_linkedin_connect and choose grants anew. reconnect_required applies only to an existing connection; reconnect is managed by the owning application.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/local.js

@@ -1,6 +1,6 @@
 export const businessFindTool = {
     name: "oneshot_business_find",
-    description: "Discover local main-street businesses (restaurants, contractors, dental practices, auto shops) by category or keywords in a location. Use this instead of people_search for independent local businesses. Flat price per search. Paid tool.",
+    description: "Discover local main-street businesses (restaurants, contractors, dental practices, auto shops) by category or keywords in a location. Use this instead of person_find for independent local businesses. Flat price per search. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/lookup-manifest.generated.js

@@ -12,15 +12,15 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "name": {
                     "type": "string",
-                    "description": "The bank's name, 2 to 100 characters, for example Grasshopper Bank. A text match: similarly named banks are returned too"
+                    "description": "The bank's name, for example Grasshopper Bank. A text match: similarly named banks are returned too. 2 to 100 characters."
                 },
                 "fdic_certificate": {
                     "type": "integer",
-                    "description": "The FDIC certificate number, for example 59113. An exact match; preferred over a name"
+                    "description": "The FDIC certificate number, for example 59113. An exact match; preferred over a name. At least 1."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most banks to return (1 to 10, default 5)"
+                    "description": "Most banks to return. From 1 to 10. Defaults to `5`."
                 }
             },
             "required": []
@@ -39,11 +39,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "condition": {
                     "type": "string",
-                    "description": "A condition or disease, for example psoriasis"
+                    "description": "A condition or disease, for example psoriasis. 2 to 120 characters."
                 },
                 "query": {
                     "type": "string",
-                    "description": "A treatment or other search words, for example secukinumab"
+                    "description": "A treatment or other search words, for example secukinumab. 2 to 200 characters."
                 },
                 "status": {
                     "type": "string",
@@ -56,11 +56,11 @@ export const LOOKUP_MANIFEST = [
                         "withdrawn",
                         "suspended"
                     ],
-                    "description": "Only studies with this status: recruiting, not_yet_recruiting, active_not_recruiting, completed, terminated, withdrawn or suspended"
+                    "description": "Only studies with this status"
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most studies to return. Default 10"
+                    "description": "The most studies to return. From 1 to 20. Defaults to `10`."
                 }
             },
             "required": []
@@ -82,23 +82,23 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "cik": {
                     "type": "string",
-                    "description": "The 1 to 10 digit registry identifier (CIK), for example 320193. Shorter numbers are padded with zeros"
+                    "description": "The registry identifier (CIK), for example 320193. Shorter numbers are padded with zeros. A CIK is 1 to 10 digits."
                 },
                 "form": {
                     "type": "string",
-                    "description": "Only filings of this exact form type, for example 10-K"
+                    "description": "Only filings of this exact form type, for example 10-K. 1 to 20 characters."
                 },
                 "filed_after": {
                     "type": "string",
-                    "description": "Only filings made on or after this date, YYYY-MM-DD"
+                    "description": "Only filings made on or after this date. Use YYYY-MM-DD."
                 },
                 "filed_before": {
                     "type": "string",
-                    "description": "Only filings made on or before this date, YYYY-MM-DD"
+                    "description": "Only filings made on or before this date. Use YYYY-MM-DD."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most filings to return, newest first (1 to 50, default 10)"
+                    "description": "Most filings to return, newest first. From 1 to 50. Defaults to `10`."
                 }
             },
             "required": [
@@ -121,15 +121,15 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "company_name": {
                     "type": "string",
-                    "description": "The financial company's name, 2 to 100 characters, for example Wells Fargo"
+                    "description": "The financial company's name, for example Wells Fargo. 2 to 100 characters."
                 },
                 "since": {
                     "type": "string",
-                    "description": "Count only complaints received on or after this date, YYYY-MM-DD; default all"
+                    "description": "Count only complaints received on or after this date. Use YYYY-MM-DD."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most complaints to return, newest first, 1 to 25; default 10"
+                    "description": "Most complaints to return, newest first. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -141,6 +141,65 @@ export const LOOKUP_MANIFEST = [
             "limit": 1
         }
     },
+    {
+        "name": "record_court_cases_find",
+        "path": "find/record-court-cases",
+        "title": "Court Cases",
+        "description": "Search a public archive of published US federal and state court opinions, or choose kind=dockets to search federal cases and their filings. Returns case names, courts, filing dates, citations when available, docket numbers, short excerpts and links, ordered by relevance. For opinions, the filing date is the decision date; for dockets, it is when the case was filed. Coverage varies by court and does not include every case or filing. Only the first page is read, with at most limit matches returned. Docket totals above 2,000 are approximate, with up to 6% error. An excerpt is the start of an opinion or a matching filing, at most 500 characters; it is not a case summary. Open the URL for the source record. The source's terms prohibit using this data for credit, insurance, employment, housing or other eligibility decisions covered by the Fair Credit Reporting Act.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": "Search words, with quotes for an exact phrase and AND, OR or NOT between terms, for example patent. 1 to 500 characters."
+                },
+                "kind": {
+                    "type": "string",
+                    "enum": [
+                        "opinions",
+                        "dockets"
+                    ],
+                    "description": "opinions searches published federal and state decisions; dockets searches federal cases and their filings. Default opinions. Defaults to `\"opinions\"`."
+                },
+                "court": {
+                    "type": "string",
+                    "description": "Only this court, by its short court ID, for example scotus, cafc or txed"
+                },
+                "filed_after": {
+                    "type": "string",
+                    "description": "Only cases filed on or after this date, YYYY-MM-DD; for opinions, this is the decision date"
+                },
+                "filed_before": {
+                    "type": "string",
+                    "description": "Only cases filed on or before this date, YYYY-MM-DD; for opinions, this is the decision date"
+                },
+                "case_name": {
+                    "type": "string",
+                    "description": "Search within case names, for example Merck. 1 to 200 characters."
+                },
+                "docket_number": {
+                    "type": "string",
+                    "description": "Search within docket numbers, for example 23-1027. 1 to 100 characters."
+                },
+                "limit": {
+                    "type": "integer",
+                    "description": "The most matches to return from the first page, from 1 to 20. Default 10. From 1 to 20. Defaults to `10`."
+                }
+            },
+            "required": [
+                "query"
+            ]
+        },
+        "example": {
+            "query": "patent",
+            "court": "cafc",
+            "case_name": "Merck",
+            "docket_number": "23-1027",
+            "filed_after": "2025-01-01",
+            "filed_before": "2025-12-31",
+            "limit": 1
+        }
+    },
     {
         "name": "place_disasters",
         "path": "lookup/place-disasters",
@@ -151,27 +210,27 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "state": {
                     "type": "string",
-                    "description": "Two-letter state postal code, for example TX"
+                    "description": "State postal code. A state is its two-letter postal code, for example TX."
                 },
                 "county": {
                     "type": "string",
-                    "description": "County or parish name without the word County or Parish, for example Harris"
+                    "description": "County or parish name without the word County or Parish, for example Harris. A county name has 2 to 40 letters, spaces, periods, apostrophes and hyphens, without \"County\" or \"Parish\"."
                 },
                 "incident_type": {
                     "type": "string",
-                    "description": "Only declarations for this incident type, for example Flood, Hurricane, Fire, Tornado, Severe Storm"
+                    "description": "Only declarations for this incident type. An incident type is words such as Flood, Hurricane or Fire."
                 },
                 "declared_after": {
                     "type": "string",
-                    "description": "Only declarations made on or after this date (YYYY-MM-DD)"
+                    "description": "Only declarations made on or after this date. Use YYYY-MM-DD."
                 },
                 "declared_before": {
                     "type": "string",
-                    "description": "Only declarations made on or before this date (YYYY-MM-DD)"
+                    "description": "Only declarations made on or before this date. Use YYYY-MM-DD."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most declarations to return, newest first. Default 25"
+                    "description": "Most declarations to return, newest first. Default 25. From 1 to 100."
                 }
             },
             "required": [
@@ -198,11 +257,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "drug_name": {
                     "type": "string",
-                    "description": "The drug's name as it appears on the reports, for example Ozempic or metformin"
+                    "description": "The drug's name as it appears on the reports, for example Ozempic or metformin. 2 to 100 characters."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most reactions to return. Default 10"
+                    "description": "The most reactions to return. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -224,7 +283,7 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "drug_name": {
                     "type": "string",
-                    "description": "The drug's generic or brand name, for example quinapril or sodium chloride"
+                    "description": "The drug's generic or brand name, for example quinapril or sodium chloride. 2 to 100 characters."
                 },
                 "status": {
                     "type": "string",
@@ -233,11 +292,11 @@ export const LOOKUP_MANIFEST = [
                         "to_be_discontinued",
                         "resolved"
                     ],
-                    "description": "Only presentations with this status: current, to_be_discontinued or resolved. Default all three"
+                    "description": "Only presentations with this status; all statuses when omitted"
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most presentations to return. Default 10"
+                    "description": "The most presentations to return. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -260,11 +319,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "query": {
                     "type": "string",
-                    "description": "A tariff heading such as 7408.11, or a keyword such as copper wire. Several words match any of them; wrap them in double quotes for the exact phrase"
+                    "description": "A tariff heading such as 7408.11, or a keyword such as copper wire. Several words match any of them; wrap them in double quotes for the exact phrase. 2 to 80 characters."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most lines to return, in schedule order. Default 20"
+                    "description": "Most lines to return, in schedule order. From 1 to 50. Defaults to `20`."
                 }
             },
             "required": [
@@ -286,31 +345,31 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "latitude": {
                     "type": "number",
-                    "description": "Latitude in decimal degrees, -90 to 90, for example 37.77"
+                    "description": "Latitude in decimal degrees, for example 37.77. From -90 to 90."
                 },
                 "longitude": {
                     "type": "number",
-                    "description": "Longitude in decimal degrees, -180 to 180 (west is negative), for example -122.42"
+                    "description": "Longitude in decimal degrees (west is negative), for example -122.42. From -180 to 180."
                 },
                 "radius_km": {
                     "type": "number",
-                    "description": "Distance from the point in kilometres, 1 to 500; default 100"
+                    "description": "Distance from the point in kilometres. From 1 to 500. Defaults to `100`."
                 },
                 "since": {
                     "type": "string",
-                    "description": "Earliest date, YYYY-MM-DD (UTC); default 30 days before the call"
+                    "description": "Earliest date (UTC); default 30 days before the call. Use YYYY-MM-DD."
                 },
                 "until": {
                     "type": "string",
-                    "description": "Latest date, YYYY-MM-DD (UTC); default now"
+                    "description": "Latest date (UTC); default now. Use YYYY-MM-DD."
                 },
                 "min_magnitude": {
                     "type": "number",
-                    "description": "Smallest magnitude to return, 0 to 10; default 2.5"
+                    "description": "Smallest magnitude to return. From 0 to 10. Defaults to `2.5`."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most earthquakes to return, 1 to 50; default 10"
+                    "description": "Most earthquakes to return. From 1 to 50. Defaults to `10`."
                 }
             },
             "required": [
@@ -337,11 +396,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "recipient": {
                     "type": "string",
-                    "description": "Recipient name, for example LOCKHEED MARTIN CORPORATION. A text match: similarly named recipients are returned too"
+                    "description": "Recipient name, for example LOCKHEED MARTIN CORPORATION. A text match: similarly named recipients are returned too. 3 to 120 characters."
                 },
                 "uei": {
                     "type": "string",
-                    "description": "The recipient's 12-character Unique Entity Identifier. Preferred over a name"
+                    "description": "The recipient's Unique Entity Identifier. Preferred over a name. A UEI is 12 letters and digits."
                 },
                 "kind": {
                     "type": "string",
@@ -349,19 +408,19 @@ export const LOOKUP_MANIFEST = [
                         "contracts",
                         "grants"
                     ],
-                    "description": "Which group of awards to list: contracts, or grants"
+                    "description": "Which group of awards to list"
                 },
                 "active_after": {
                     "type": "string",
-                    "description": "Start of the period to search, YYYY-MM-DD, not before 2007-10-01. Default: three years before active_before"
+                    "description": "Start of the period to search, not before 2007-10-01. Default: three years before active_before. Use YYYY-MM-DD."
                 },
                 "active_before": {
                     "type": "string",
-                    "description": "End of the period to search, YYYY-MM-DD. Default: today"
+                    "description": "End of the period to search. Default: today. Use YYYY-MM-DD."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most awards to return, largest first (1 to 25, default 10)"
+                    "description": "Most awards to return, largest first. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -384,11 +443,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "role": {
                     "type": "string",
-                    "description": "Words to look up, for example software engineer. Matched as a keyword search across labor category, contractor name and contract number, so some rates may not be for that job title"
+                    "description": "Words to look up, for example software engineer. Matched as a keyword search across labor category, contractor name and contract number, so some rates may not be for that job title. 2 to 80 characters."
                 },
                 "min_years_experience": {
                     "type": "integer",
-                    "description": "Only rates for roles that ask for at least this many years of experience"
+                    "description": "Only rates for roles that ask for at least this many years of experience. From 0 to 45."
                 },
                 "education": {
                     "type": "string",
@@ -403,7 +462,7 @@ export const LOOKUP_MANIFEST = [
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most rates to list. Default 10. The summary always covers every match"
+                    "description": "The most rates to list. The summary always covers every match. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -425,7 +484,7 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "query": {
                     "type": "string",
-                    "description": "Search words, for example drone registration"
+                    "description": "Search words, for example drone registration. 2 to 200 characters."
                 },
                 "type": {
                     "type": "string",
@@ -435,23 +494,23 @@ export const LOOKUP_MANIFEST = [
                         "notice",
                         "presidential"
                     ],
-                    "description": "Only this kind of document: rule, proposed_rule, notice or presidential"
+                    "description": "Only this kind of document"
                 },
                 "agency": {
                     "type": "string",
-                    "description": "Only documents from this agency, as its Federal Register slug, for example federal-aviation-administration"
+                    "description": "Only documents from this agency, as its Federal Register slug, for example federal-aviation-administration. 2 to 80 characters."
                 },
                 "published_after": {
                     "type": "string",
-                    "description": "Only documents published on or after this date, YYYY-MM-DD"
+                    "description": "Only documents published on or after this date. Use YYYY-MM-DD."
                 },
                 "published_before": {
                     "type": "string",
-                    "description": "Only documents published on or before this date, YYYY-MM-DD"
+                    "description": "Only documents published on or before this date. Use YYYY-MM-DD."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most documents to return. Default 10"
+                    "description": "The most documents to return. From 1 to 20. Defaults to `10`."
                 }
             },
             "required": [
@@ -474,11 +533,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "latitude": {
                     "type": "number",
-                    "description": "Latitude in decimal degrees, 17 to 72"
+                    "description": "Latitude in decimal degrees. From 17 to 72."
                 },
                 "longitude": {
                     "type": "number",
-                    "description": "Longitude in decimal degrees, -180 to -64"
+                    "description": "Longitude in decimal degrees. From -180 to -64."
                 }
             },
             "required": [
@@ -501,27 +560,27 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "npi": {
                     "type": "string",
-                    "description": "The 10-digit provider number. Give this, or a last name and state, never both"
+                    "description": "The health provider number. Give this, or a last name and state, never both. A health provider number is exactly 10 digits."
                 },
                 "last_name": {
                     "type": "string",
-                    "description": "Last name of the practitioner. Needs state"
+                    "description": "Last name of the practitioner. Needs state. 1 to 100 characters."
                 },
                 "state": {
                     "type": "string",
-                    "description": "Two-letter US state code, such as TX. Needs last name"
+                    "description": "US state code. Needs last name. A state is two capital letters, such as TX."
                 },
                 "first_name": {
                     "type": "string",
-                    "description": "First name of the practitioner, to narrow a name search"
+                    "description": "First name of the practitioner, to narrow a name search. 1 to 100 characters."
                 },
                 "city": {
                     "type": "string",
-                    "description": "A city, to narrow a name search"
+                    "description": "A city, to narrow a name search. 1 to 100 characters."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most providers to return from a name search, 1 to 20"
+                    "description": "Most providers to return from a name search. From 1 to 20. Defaults to `5`."
                 }
             },
             "required": []
@@ -540,11 +599,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "zip_code": {
                     "type": "string",
-                    "description": "A five-digit US ZIP code, for example 45220"
+                    "description": "A US ZIP code, for example 45220. zip_code must be five digits."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most hospitals to return. Default 10"
+                    "description": "The most hospitals to return. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -566,15 +625,15 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "lei": {
                     "type": "string",
-                    "description": "The 20-character Legal Entity Identifier, for example DPRBOZP0K5RM2YE8UU08. An exact match; preferred over a name"
+                    "description": "The Legal Entity Identifier, for example DPRBOZP0K5RM2YE8UU08. An exact match; preferred over a name. A Legal Entity Identifier is 20 letters and digits."
                 },
                 "name": {
                     "type": "string",
-                    "description": "Legal name, for example Lockheed Martin Corporation. A text match: similarly named entities are returned too"
+                    "description": "Legal name, for example Lockheed Martin Corporation. A text match: similarly named entities are returned too. 2 to 200 characters."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most entities to return (1 to 10, default 5)"
+                    "description": "Most entities to return. From 1 to 10. Defaults to `5`."
                 }
             },
             "required": []
@@ -593,11 +652,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "dot_number": {
                     "type": "string",
-                    "description": "The carrier's US Department of Transportation number, 1 to 8 digits, for example 44110"
+                    "description": "The carrier's US Department of Transportation number, for example 44110. dot_number must be 1 to 8 digits."
                 },
                 "mc_number": {
                     "type": "string",
-                    "description": "The carrier's motor carrier (MC) number, 1 to 8 digits, with an optional MC or MC- in front, for example MC-1515"
+                    "description": "The carrier's motor carrier (MC) number, for example MC-1515. mc_number must be 1 to 8 digits, with an optional MC or MC- in front."
                 }
             },
             "required": []
@@ -616,7 +675,7 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "address": {
                     "type": "string",
-                    "description": "A US street address on one line, with city and state or ZIP, for example 1600 Pennsylvania Ave NW, Washington, DC"
+                    "description": "A US street address on one line, with city and state or ZIP, for example 1600 Pennsylvania Ave NW, Washington, DC. 5 to 200 characters."
                 }
             },
             "required": [
@@ -643,19 +702,19 @@ export const LOOKUP_MANIFEST = [
                         "drug",
                         "device"
                     ],
-                    "description": "Which products and which regulator: consumer (Consumer Product Safety Commission), or food, drug or device (Food and Drug Administration). Required"
+                    "description": "Which products and which regulator: consumer (Consumer Product Safety Commission), or food, drug or device (Food and Drug Administration)"
                 },
                 "product_name": {
                     "type": "string",
-                    "description": "Words from the product name, for example attic stairway. For food, drug and device: letters, digits, spaces and . , ' & - only"
+                    "description": "Words from the product name, for example attic stairway. For food, drug and device: letters, digits, spaces and . , ' & - only. 2 to 80 characters."
                 },
                 "title": {
                     "type": "string",
-                    "description": "Words from the recall title, for example ladder. Category consumer only"
+                    "description": "Words from the recall title, for example ladder. Category consumer only. 2 to 80 characters."
                 },
                 "manufacturer": {
                     "type": "string",
-                    "description": "The manufacturer, importer, distributor or retailer, for example Louisville Ladder. For food, drug and device it is the recalling firm: letters, digits, spaces and . , ' & - only"
+                    "description": "The manufacturer, importer, distributor or retailer, for example Louisville Ladder. For food, drug and device it is the recalling firm: letters, digits, spaces and . , ' & - only. 2 to 80 characters."
                 },
                 "classification": {
                     "type": "string",
@@ -668,15 +727,15 @@ export const LOOKUP_MANIFEST = [
                 },
                 "recalled_after": {
                     "type": "string",
-                    "description": "Only recalls announced on or after this date, YYYY-MM-DD. Needs a product name, title or manufacturer"
+                    "description": "Only recalls announced on or after this date. Needs a product name, title or manufacturer. Use YYYY-MM-DD."
                 },
                 "recalled_before": {
                     "type": "string",
-                    "description": "Only recalls announced on or before this date, YYYY-MM-DD. Needs a product name, title or manufacturer"
+                    "description": "Only recalls announced on or before this date. Needs a product name, title or manufacturer. Use YYYY-MM-DD."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most recalls to return. Default 10"
+                    "description": "The most recalls to return. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -733,7 +792,7 @@ export const LOOKUP_MANIFEST = [
                 },
                 "vat_number": {
                     "type": "string",
-                    "description": "The VAT number, 2 to 14 letters and digits once spaces, dots and dashes are removed; a leading country code equal to country is removed"
+                    "description": "The VAT number, 2 to 14 letters and digits once spaces, dots and dashes are removed; a leading country code equal to country is removed. 2 to 40 characters. letters, digits, spaces, dots and dashes only."
                 }
             },
             "required": [
@@ -756,19 +815,19 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "make": {
                     "type": "string",
-                    "description": "The vehicle make, for example Honda"
+                    "description": "The vehicle make, for example Honda. 2 to 40 characters. Letters, digits, spaces and hyphens only."
                 },
                 "model": {
                     "type": "string",
-                    "description": "The vehicle model, for example CR-V"
+                    "description": "The vehicle model, for example CR-V. 1 to 60 characters. Letters, digits, spaces, periods and hyphens only."
                 },
                 "model_year": {
                     "type": "integer",
-                    "description": "The model year, from 1950 to next year"
+                    "description": "The model year. At least 1950. Model year cannot be later than next year."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most complaints to return, newest first. Default 10"
+                    "description": "The most complaints to return, newest first. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -794,11 +853,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "vin": {
                     "type": "string",
-                    "description": "The 17-character vehicle identification number"
+                    "description": "The vehicle identification number. A VIN is 17 characters: digits and capital letters, never I, O or Q."
                 },
                 "model_year": {
                     "type": "integer",
-                    "description": "Model year, when known. Resolves the year for numbers where position 10 is ambiguous"
+                    "description": "Model year, when known. Resolves the year for numbers where position 10 is ambiguous. From 1981 to 2100."
                 }
             },
             "required": [
@@ -819,19 +878,19 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "make": {
                     "type": "string",
-                    "description": "The vehicle make, for example Honda"
+                    "description": "The vehicle make, for example Honda. 2 to 40 characters. Letters, digits, spaces and hyphens only."
                 },
                 "model": {
                     "type": "string",
-                    "description": "The vehicle model, for example CR-V"
+                    "description": "The vehicle model, for example CR-V. 1 to 60 characters. Letters, digits, spaces, periods and hyphens only."
                 },
                 "model_year": {
                     "type": "integer",
-                    "description": "The model year, from 1950 to next year"
+                    "description": "The model year. At least 1950. Model year cannot be later than next year."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "The most recalls to return. Default 25"
+                    "description": "The most recalls to return. From 1 to 50. Defaults to `25`."
                 }
             },
             "required": [
@@ -857,7 +916,7 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "cve_id": {
                     "type": "string",
-                    "description": "The CVE identifier, for example CVE-2021-44228. Lower case is accepted"
+                    "description": "The CVE identifier, for example CVE-2021-44228. Lower case is accepted. A CVE identifier is CVE-, a four-digit year, a dash and four or more digits."
                 }
             },
             "required": [
@@ -878,11 +937,11 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "latitude": {
                     "type": "number",
-                    "description": "Latitude in decimal degrees, 17 to 72, for example 29.7604"
+                    "description": "Latitude in decimal degrees, for example 29.7604. From 17 to 72."
                 },
                 "longitude": {
                     "type": "number",
-                    "description": "Longitude in decimal degrees, -180 to -64 (west is negative), for example -95.3698"
+                    "description": "Longitude in decimal degrees (west is negative), for example -95.3698. From -180 to -64."
                 }
             },
             "required": [
@@ -905,19 +964,19 @@ export const LOOKUP_MANIFEST = [
             "properties": {
                 "latitude": {
                     "type": "number",
-                    "description": "Latitude in decimal degrees, -90 to 90, for example 44.7"
+                    "description": "Latitude in decimal degrees, for example 44.7. From -90 to 90."
                 },
                 "longitude": {
                     "type": "number",
-                    "description": "Longitude in decimal degrees, -180 to 180 (west is negative), for example -120.0"
+                    "description": "Longitude in decimal degrees (west is negative), for example -120.0. From -180 to 180."
                 },
                 "radius_km": {
                     "type": "number",
-                    "description": "Distance from the point in kilometres, 1 to 200; default 50"
+                    "description": "Distance from the point in kilometres. From 1 to 200. Defaults to `50`."
                 },
                 "limit": {
                     "type": "integer",
-                    "description": "Most fires to return, 1 to 25; default 10"
+                    "description": "Most fires to return. From 1 to 25. Defaults to `10`."
                 }
             },
             "required": [
@@ -984,6 +1043,66 @@ export const ROUTE_MANIFEST = [
             "key": "HONDA:CR-V:2019"
         }
     },
+    {
+        "name": "place_permits",
+        "method": "POST",
+        "path": "/v1/tools/lookup/place-permits",
+        "paid": true,
+        "readOnly": true,
+        "title": "Building Permits",
+        "description": "Look up recorded building permits at an exact site address in Chicago or New York City. NYC coverage is the legacy permit issuance dataset, excluding DOB NOW. Supply an NYC borough. Chicago covers permits since 2006, excluding voided or revoked permits. Returns permit type, source status, dates, description, declared value and business contractors where published. Optional issue-date and permit-type filters. No match does not prove no work occurred. Data checked daily; missing, failed or stale ingests fail the call. Outside coverage is refused before payment. Paid per call.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "street_address": {
+                    "type": "string",
+                    "description": "Site street address with number and source spelling; no unit or city"
+                },
+                "city": {
+                    "type": "string",
+                    "description": "Chicago or New York City; an NYC borough name is also accepted"
+                },
+                "state": {
+                    "type": "string",
+                    "description": "Two-letter US state code"
+                },
+                "borough": {
+                    "type": "string",
+                    "description": "NYC borough, required when city is New York City"
+                },
+                "issued_from": {
+                    "type": "string",
+                    "description": "First issue date inclusive, YYYY-MM-DD"
+                },
+                "issued_to": {
+                    "type": "string",
+                    "description": "Last issue date inclusive, YYYY-MM-DD"
+                },
+                "permit_type": {
+                    "type": "string",
+                    "description": "Exact source permit type, case insensitive"
+                },
+                "limit": {
+                    "type": "integer",
+                    "description": "Page size, 1-100, default 50"
+                },
+                "offset": {
+                    "type": "integer",
+                    "description": "Results to skip, 0-10000, default 0"
+                }
+            },
+            "required": [
+                "street_address",
+                "city",
+                "state"
+            ]
+        },
+        "example": {
+            "street_address": "7529 N CLARK ST",
+            "city": "Chicago",
+            "state": "IL"
+        }
+    },
     {
         "name": "watch_update",
         "method": "PATCH",

package/dist/tools/nyne.d.ts

@@ -1,16 +1,16 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
 import type { OneShot } from "@oneshot-agent/sdk";
-export declare const deepResearchPersonTool: Tool;
-export declare const socialProfilesTool: Tool;
-export declare const articleSearchTool: Tool;
-export declare const personNewsfeedTool: Tool;
+export declare const personDossierTool: Tool;
+export declare const personSocialAccountsTool: Tool;
+export declare const personArticlesTool: Tool;
+export declare const personPostsTool: Tool;
 export declare const personInterestsTool: Tool;
-export declare const personInteractionsTool: Tool;
+export declare const personFollowersTool: Tool;
 /** Deep person research fans out across several providers; the SDK's 120s default was too short. */
-export declare const DEEP_RESEARCH_PERSON_TIMEOUT_SEC = 300;
-export declare function handleDeepResearchPerson(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").DeepResearchPersonResult>;
-export declare function handleSocialProfiles(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SocialProfilesResult>;
-export declare function handleArticleSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ArticleSearchResult>;
-export declare function handlePersonNewsfeed(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonNewsfeedResult>;
+export declare const PERSON_DOSSIER_TIMEOUT_SEC = 300;
+export declare function handlePersonDossier(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonDossierResult>;
+export declare function handlePersonSocialAccounts(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonSocialAccountsResult>;
+export declare function handlePersonArticles(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonArticlesResult>;
+export declare function handlePersonPosts(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonPostsResult>;
 export declare function handlePersonInterests(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonInterestsResult>;
-export declare function handlePersonInteractions(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonInteractionsResult>;
+export declare function handlePersonFollowers(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonFollowersResult>;

package/dist/tools/nyne.js

@@ -1,6 +1,6 @@
-export const deepResearchPersonTool = {
-    name: "oneshot_deep_research_person",
-    description: "Deep research on a person — returns career history, social presence, interests, and connections. Takes 2-5 minutes. Paid tool.",
+export const personDossierTool = {
+    name: "oneshot_person_dossier",
+    description: "Get a person’s profile, known social accounts, articles, posts and written summary. Takes 2-5 minutes. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {
@@ -11,8 +11,8 @@ export const deepResearchPersonTool = {
         },
     },
 };
-export const socialProfilesTool = {
-    name: "oneshot_social_profiles",
+export const personSocialAccountsTool = {
+    name: "oneshot_person_social_accounts",
     description: "Discover all social media profiles for a person across platforms (LinkedIn, Twitter, GitHub, YouTube, etc). Paid tool.",
     inputSchema: {
         type: "object",
@@ -22,8 +22,8 @@ export const socialProfilesTool = {
         },
     },
 };
-export const articleSearchTool = {
-    name: "oneshot_article_search",
+export const personArticlesTool = {
+    name: "oneshot_person_articles",
     description: "Find articles, publications, and interviews about a person. Requires name and company. Paid tool.",
     inputSchema: {
         type: "object",
@@ -36,8 +36,8 @@ export const articleSearchTool = {
         required: ["name", "company"],
     },
 };
-export const personNewsfeedTool = {
-    name: "oneshot_person_newsfeed",
+export const personPostsTool = {
+    name: "oneshot_person_posts",
     description: "Get a person's recent social media posts with likes, replies, and shares. Paid tool.",
     inputSchema: {
         type: "object",
@@ -59,8 +59,8 @@ export const personInterestsTool = {
         },
     },
 };
-export const personInteractionsTool = {
-    name: "oneshot_person_interactions",
+export const personFollowersTool = {
+    name: "oneshot_person_followers",
     description: "See who someone follows, who follows them, and who they reply to. Paid tool.",
     inputSchema: {
         type: "object",
@@ -73,32 +73,32 @@ export const personInteractionsTool = {
     },
 };
 /** Deep person research fans out across several providers; the SDK's 120s default was too short. */
-export const DEEP_RESEARCH_PERSON_TIMEOUT_SEC = 300;
-export async function handleDeepResearchPerson(agent, args) {
-    return agent.deepResearchPerson({
+export const PERSON_DOSSIER_TIMEOUT_SEC = 300;
+export async function handlePersonDossier(agent, args) {
+    return agent.personDossier({
         email: args.email,
         social_media_url: args.social_media_url,
         name: args.name,
         company: args.company,
-        timeout: DEEP_RESEARCH_PERSON_TIMEOUT_SEC,
+        timeout: PERSON_DOSSIER_TIMEOUT_SEC,
     });
 }
-export async function handleSocialProfiles(agent, args) {
-    return agent.socialProfiles({
+export async function handlePersonSocialAccounts(agent, args) {
+    return agent.personSocialAccounts({
         email: args.email,
         social_media_url: args.social_media_url,
     });
 }
-export async function handleArticleSearch(agent, args) {
-    return agent.articleSearch({
+export async function handlePersonArticles(agent, args) {
+    return agent.personArticles({
         name: args.name,
         company: args.company,
         sort: args.sort,
         limit: args.limit,
     });
 }
-export async function handlePersonNewsfeed(agent, args) {
-    return agent.personNewsfeed({
+export async function handlePersonPosts(agent, args) {
+    return agent.personPosts({
         social_media_url: args.social_media_url,
     });
 }
@@ -109,8 +109,8 @@ export async function handlePersonInterests(agent, args) {
         social_media_url: args.social_media_url,
     });
 }
-export async function handlePersonInteractions(agent, args) {
-    return agent.personInteractions({
+export async function handlePersonFollowers(agent, args) {
+    return agent.personFollowers({
         social_media_url: args.social_media_url,
         type: args.type,
         max_results: args.max_results,

package/dist/tools/people.d.ts

@@ -1,4 +1,4 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
 import type { OneShot } from "@oneshot-agent/sdk";
-export declare const peopleSearchTool: Tool;
-export declare function handlePeopleSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PeopleSearchResult>;
+export declare const personFindTool: Tool;
+export declare function handlePersonFind(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PersonFindResult>;

package/dist/tools/people.js

@@ -1,5 +1,5 @@
-export const peopleSearchTool = {
-    name: "oneshot_people_search",
+export const personFindTool = {
+    name: "oneshot_person_find",
     description: "Search for people by job title, company, location, skills, etc. Returns professional profiles. Paid tool — quote provided before payment.",
     inputSchema: {
         type: "object",
@@ -55,8 +55,8 @@ export const peopleSearchTool = {
         },
     },
 };
-export async function handlePeopleSearch(agent, args) {
-    return agent.peopleSearch({
+export async function handlePersonFind(agent, args) {
+    return agent.personFind({
         job_titles: args.job_titles,
         keywords: args.keywords,
         companies: args.companies,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "MCP server for OneShot - 81 tools for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,7 @@
   "dependencies": {
     "@coinbase/cdp-sdk": "1.45.0",
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@oneshot-agent/sdk": "^0.51.0",
+    "@oneshot-agent/sdk": "^0.52.0",
     "zod": "3.25.76"
   },
   "devDependencies": {